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はじめに 


このたびは、 r MSX DatapackturboR 版 j をお荑 v、h げいただきまして、城にありがと 
うございます， r MSX-DatapackturboR®」 は MSX turbo R のれ涤と解说したマニユア 
ルとサンブルプ D グラムとをセットにしたパッケージです。すでに発 5E している 「MSX- 
Datapackj は、 MSX、MSXj , MSX 3+ の仕樣を解説したもので、 r MSX Datapack turbo 
K 版 j はその絞 W という位黄づけになっています。したがって、このパッケージで解说して 
いる内容は、 MSX turboR で追加 • *更された仕嫌です。従米と互換11のある部分 (BASIC 
や BIOS, VDP など）については、 r MSX-Datapackj をご#照下さい。 

さて、1983年に S 場した MSX ホームパーソナルコンビユータは， MSXj , MSX 2+ へとキ. 
にグラフィックを強イ匕して来ました，そして、 MSXturboR では、 ZS •互換の新 CPU R800 
を椹 W することにより、 f 均10倍の高速％理を实現しつつ、保米の MSX との h 位互換性を 
保っています。 

MSX の B； 换性を守ってゆくために、ハ-ドウ*アおよびソフトウ；！アを作成するときは 
このパッケージの内容をルールとして守って下さい。 


このパ >5■ケージには KIT のものが含まれています。 
MSX-Datapack turbo R 販マニュアル 1册 

MSX-Datapack turbo R 坂サンブルディスク 1枚 
(3.5-2DD フロッビーデイスタ） 


• d MSX-Datapack turbo R 版、 MSXView は株式会社アスキーの商®です。 

• MS-DOS は米面マイク ci ソフト社の商!*です。 

• CP/M は米 IS1 デジタルリサーチ社の商揉です。 


in 



ご注意 

1. この V7 トウ;!■アおよび7ニュアルの一部または全部を株式会社アスキーの文兹によ 
る許可なくして«製することは，メディアの形態を問わず禁じます- 

2. このソフトウ*アおよびマニュアルは M 人として利用するほかは、»作 W 上、株式会 
社アスキーに無断で使用することはできません， 

3. このマニュアルに5己«されている亊 MU 、将米予告なく変史することがありますが. 
当社に a» されている方にはご案内をお送り致します。 

4. «品の内容については万全を期しておりますが、製品の内容についてのご不審ゃ淇り 
マニュアルのれなど、お51 づきのことがございましたら、7ニュアルの*末の 
1 ■お問い合わせについて j の要領で問い介わせ下さい • 

5. このソフトウ*アを運用した結果の彩»については、4項にかかわらず、 H 任を M いか 
ねますのでご了承 F さい • 



このマニュアルの表記法 


1. @などはキーボードに刻印されているとおりに去 S します。 

2. リターンキーは (j»^TUR_P{Ji たは〔4*1、フ T ンクシ9ンキーは lEil などと表記します。 

3. し.を押しながら...を押す j といったキー描作に関しては 
(SHIFT)+ [Ff) 

ICTR^ + fSTOPI 
のように表記します。 

4. ディスプレイに表示される文字に開しては 


のように MA ます。この例では、幽而に ICTRl^l +fXl が表示されたことを示します。 

5. MSX turbo R では、 MSX 2+ などと向じぐ BIOS が MAIN ROM と SUB ROM に分 
割されています。これを K 別するため、以 F のように表紀します。 

CHGET(009FH/MAIN) MAIN ROM の 009FH 番地 
REDCLK(01F5H/SUB) SUB ROM の 01F5H 番地 

6. 7 —クエリアおよびフックは、以下のように表紀します。 

[VALTYP(0F663H.l)] 0F663H * 地の1パイトを ft 用 
[BUF(0F55EH,258)] 0F55EH »地以降の258パイトを使用 

マ. 原則的に入力する文卞は大文字、小文字を問いませんが、大文字とイ、文字の区別が必要 
なときは、マニュアルにその宵を記載します。全角文字と半角文字は必ず区別します。 
8. 知っていると便利な衍報は 






9. こ <» マニュアル中で示される MSX の肉而は，レイアウトなどの都合I、搜铕比が® 
わっているこ！:があ0ます。あらかじめご了承ドさい。 

10. その他は必要に lb じて解説します。 
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MSX turbo 尺とは 


システム構成 


i で tt、 新 CPU の R800 を始めとした， MSX turbo R のハードウ*ア播成を说明し 

基本仕様 

turbo R と MSX 2+ との基本的な ft 様の遠いを 一 K 表で示します， 


% 1.1 MSX turbo R t MSX 2+ i の概略什棟---锭 





第 2 京システム構成 


| MSX turbo R |MsX 2+ 

f VDP 9968相’品 _ 

解像 14 (fi 大）| 512x212 (ノンインタレ-ス 
闽曲衣ポ| | 512x421 (インタレ-ス時） 

I a ふ也 册大> 19268 e. 

ハードウェア 1 拟•横 


AY -3-8910 ffi S 品 _ 

MSX AUDIO (オプション〉 
[MSX-MUSIC 1 

I MSX MIDI 
(オブシ s ン> 


T FSK 1JA 1200 - 2il)Ubp« 


I MS DOS 2.11 準* 


々ートりッジスロ 


ジョイスティック |_2 _ 

| _ 潘字 ROM ®1 水準 
«字*6& t 琅2水準（ォブシ a ン> 

_»字入力_換 （MSX-JE 対応） 


リアルタイムクロック 


_| RMCIU 相’ 1 1品 



22 ハードウ j ; ア稱成 


2.2 ハー ドウ ヱァ 構成 

MSX turbo R のハードウ;!•ア供成について; iWH します， 

2.2.1 主要 LSI 

MSX turbo R は、 li に以 K の LSI を使川します。 

CPU R80II 相，(ク〇ゾク7.15909 MHz) 

Z80A 相古品（クロ y ク3.579545 MHz) 

VDP VSW58 相' 1 i 品 

PSG AY-3>8910 相’ 1 Wi 

F.\l ft#! MSX MUSIC (YM2413 

MIDI MSX-NODI (i8251 相当品と、18253または! 82M 411内品 1 

PPI i8255 相当品 

システム 1C S1990 相?4品 

2.2.2 メモリ 

MSX turbo R は以（••のメモリから構成されます。 

KOM MSX BASIC ver.4 80KB 

(MAIN ROM 32KB) 

(SUB ROM 16KB) 

(现字ドライバ 32KB) 

MSX-DOS1 16KB 

MSX-DOS2 48KB 

MSX-MUSIC 1CKD 

RAM メイン RAM 25GKB 以 I: (メモリマッパー使用） 

VRAM 128KB 

2.2.3 プロック図 

MSX turboR のシステム構成をプロック闵で说明します。 

•\1SX turbo R では2つの CPU (Z80 • R800) を搭載しました。この2つの CPU はブロ 
グラムの尖行中に、 fi 由に切り換えることができます《片方の CPU が抑作しているときは 
もうパ方は HOLD 状姐になります。2つの CPU が同時に® Jfr することはあリません。 



第 2 这システム携成 



凶 1.1MSX turbo R のプロック凶 


S1990 は、 CPU の切り換えを其塊するための-〆Xテム;！ント D —ル LSI です。 S1990 は 
その他にメモリやスロットの制鄉、ウェイト6琀の 5{1i、 および I/O デコ ー！ ••などの3ント 
ロールを行います0 

2.3 スロット構成 

MSXturboR で li, スロット構成が化されました.これは、メイン RAM が R800 に 
iE 狭つながっているか、それともスロットに筏校されているかによって、ンステム性能が大 
S く変わるためです。また、アプリケーン a ンソ7トウ*アの两 It を容 S にする、という B 
的も* 0* す. 

DOS は MSX-DOS1 と MSX-DOS2 との両方を挤載しました • スロット 3-2 のページ 
1に4枚の口 — :*ルなパンクをもって、前の3ページが MSX-DOS2、 後ろの1ページが 
MSX-DOS1 となっています。 

システム的には. 2つの CPU と2つの DOS との姐合せは0出ですが、システムを単純に 
して，ユーザーの®乱を避けるため、標準的には 

• Z80 と DOS1 (Z80 モード> 

• R800 と D 籲 S2 (11800モード） 

といつ2つの HI 合せをサポートします， 

このモー！••の切り換えはシステム起動時に、揷入されている々一トリヴジやデイスケット 
によって、自動的に判断して行われます。 










第 2 京システム ffi 成 


2.4 11800 

2.4.1 R800 の特钽 

R800 は MSX turbo R W に期発された CPU で、 U ドのよつなキ.V欲かあります • 

I, Z80 とオブジ * クトコンパチプル 

Z80 用に! If かれたゾフトウ; l アは、 CPU のタイミングに依/?する!*分を隐いて、史圯 


2. CPU ク〇ック7.15909 MHz 

命令あたりのクロ y ク a が Z80 に比べて人少しているため、 Z80 换 B ■では28.68636 MHz 
に相:与します（ノーウェイト時 >• 

3. 免？?命令 

8lnt x 8bit — および l(iV)h x16bit — 32bit の W 皮を持つ* 3： 命令をサポート 
しました。 演の士 ynT 能です。 

4. 未 i 衣命令 

Z8* では未定義だった 1X/1Y レジスタの卜.位•ド位8ビットごとのアクセスを正式に 
保疵しました。 


衣 1.2 で、なインストラクシ3ンの砷作スビ -K を示します （MSXturURtt ノーウ 
エイト略， MSX i+ は; U1 サイクルに1ウェイト人っていることを考瓛>。 

2.5 ウェイト 


•VSX turbo R では、 B800 は常にノー ウェイトでしているわけではありません。以 F 
の場分には、ウェイトサイクルが神人されます。 

1. 外部スロットをアクセスするとき <3ウェイト） 

外部スロットへアクセスするときには，今までの樹辺梭»をサボートするために、 MSX れ 
と冏じアクセスタイミングでアクセスするように; Sit •されています。 

2. 内部 ROM をアクセスすると S (2 ウェイト> 

内却 ROM とは、 BIOS, BASIC. および内*ディスク ROM などのシステムソフト 
ウ * アを格納している ROM のことです，ただし、 MSXturb«R は、初期状態では 
DIOS. BASIC. SUB ROM、 および 04 字ドライパの萌半の 16KB (升奸641<8> をメ 
イン RAM にコビーして勧作するので，ほとんどの場合は、次に述べる 3. がウェイト 
の灸件になります。 



25 ウェイト 
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だけですませて、データメモリへのアクセス（スタックも含む）が少なくなるように 
コ--ディングすると、ページアクセスモードの«点を最大®に生かすことができます • 
また、ルーブが xxOOH ~ xxFFH までにおさまるようにブ〇グラミングするといっそう 
効果的です。 


3システムタイマーを使う 

MSX turbo R では、前述のようにページブレークやリフレッシュサイクルなどの髟 
供で、 MSX 2+ のように「コーディング段 BK •命令の*行畤阳が正 ff に利る j ことがあ 
リません。したがって、 MSXturboR でも、 MSX 2+ でも W 作するようなプログラム 
を作成するためには、ソ7トウ1アループでタイミングをとることは勧められません。 
MSXturboR では、 3.91/ m で*ウントアップするシステムタイマーを搭故しているの 
で、これを利用してタイミングをとってドさい。 



システムの動作^-ド 


第：{狂ンステムの JM1- モード 


MSX turlxi R では DRAM 上におかれたシステムソフトウェアは、 ROM 丄におかれた 

システムプログラムと屻じスロノトに兄えるハート•ウ；••アになっている （S1990 が•太祝して 

いる > ので、アプリケーシ3ンブ〇グラム油では、 R8WHOM モードか R800DRAM かを 
s, ■» する必要はありまサん。 

RHIHJDKAM モードのときは、システムソフトウ s アのある DRAMU ライトブ a テクト 
されているので、 RAM としてアクセスするときはできません • システムソフトウェアとし 
て说めるだけです。 

MSX turbo RUDRAM をメモリマツパーを fc おしてアクセスしています•システムソフ 
トウェアのある DHAM It , メモリマ./パー h に文 R されている DRAM の後の4セグメ 
ントです。例えば、 MSXturboR 本体に内*されている RAM が 256KB ならば、全セグメ 
ント我は 256KB+16KB=16 セグメントとな* J、 セグメント 12-15 のセグメントが使 
われることにな9ます， 

またこの ■» セグメントは水体外«の URAM のサイズ <5にイメ _ジが J1 えます。 256KB 
であれば、セグメント»号12~15のセグメントがセグメント洛矽28~:11、 44-47, 60-63 
にも兒之ます • 内«11.从1が5121<8であればセグメント S 号 28-31 のセグメントがセグ 
メント J6 号60~63にも兄えます。 

つまリ，システムプログラムの鉍达先は、本体に内*された RAM にかかわらず、セ 
グメント浪兮60〜63になるわけです， 

Z80 モードや R800BOM モードのと S は，この4つのセグメント （i 末•使N1になります•こ 
の朗城の使い方は、6京 1 ■マッハ -—BAM セグメント j を害照して KS い。 

3.L2 Z80 モード 

Z80 モードでは、 Z80CPU が tt 作します • したがって，ンステムの籼作速 ffi は MSX2+ と 
liij じになります。 

3.2 ソフトウ： c アの起動 

アブリケーシヨンプログラムには、大きく分けて 


1.ROX1 勿ートリ y ジの梭械进プログラム 


2. ROM トリッジの BASIC プログラム 

3. フロッピーディスクの後械, ifi プログラム 

4. フロッピーヂイスクの BAS【C プログラム 


の1«妍があります。以ドでは、この 4SS のブログラムについて、どの本 iSMSX 
DOS2 と MSX D0S1 とが送択されるかを说明します。 
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3.2.1 ROM 力ートリッジの播械語プログラム 

Disk BASIC1.0 で、 ROM 々ートリ7ジの機械; S プログラムを起動するためには，いまま 
でと阎じように、カートリッジの 1N1T ルーチンで，&勘させたいプログラムへのインタース 
〇 / トコールを 【H.STKE(OFEDAH)】 に荇いて、リターンします， I 、すべての々一 
トリ y ジの初期; sa が終わ 9. _ - ■=■ ' ，が起！»す . r m h « BASIC 

1.0 の SI 境になります。 

Disk BASIC 2.0 で T ブリケーン3ンブログラムを起抑するためには、汐ートりッジの INIT 
ルーチンか、 【H.STKE(I)FEDAH)J を S 定するときに、 [USKrAB(0F39AH] に 074H を 
[USRTAB+1] に 064H を/}き込み、リタ-ンします。すると、すべてのカートリッジの初 
期ぷ定が終わ_)、アプリケーン3ンプログラムが起 WT るときは、 Disk BASIC 2.0 の戊垵 
になります。 

KOM 力ートリ/ジの榱械.1({ソフトウェアを起勘させる手*の XT 細は、 Volume 1の®2 
部7103「オートスタート j と Volum»*2 の®5部3¢ r 汐ートりッジソフトの作成法」と 
か、 r MSX^ テクニカルハンドプ y ク j の P,87 と P.328 — P.339 とを多 ML てドさい，なお 
カートリヴジソフトの作成についての SC 述は r MSX Datdpiirk.、 と f MSXj テクニ々ルハ 
ンドフック j とは同じです， 

3.2.2 ROM カートリツジの BASIC プ Q グラム 

Disk BASIC1.0 で、 ROM 々ートリッジの BASIC プログラムを«抑するためには、今ま 
でと间じように、ヘッダーの TEXT に BASIC プログラムの希地を ■»： 定します。 

Disk BASIC 2.0 で BASIC プログラムを起脚するためには、それに加えて、ヘッダーの 
IN’IT ルーチンで， IUSRTAB(0F39AH)] に07«1 を、 [USRTAB+l] に 064H を* S 込み 
ます。 

ROM トリッジの棣械 iS ソフトウェアを起勒させる- T -顢の W 細は、 Volume 1の® 2 
Sli 7.1IU 1 ■オートスター！ 'j と Volume2 の第5部3章 1 ■々—トリッジソフトの作成 iiij と 
か、 r MSX* テクニ々ルハンドブック j の P.87 と P.328—P.339 とを#照して•ドさい • なお 
力ートリ/ジソフトの作成についての Id 述は、 r MSX-Datapackj と r MSX 2 テクニカルハ 
ンドプック j とは向じです。 

3.2.3 フロッピーディスクの機械語プログラム 
AUTOEXEC.BAT によ5立ち上げ 

MSX-DOS1 で、 AUTOEXEOBAT によリプロダラムを起勒するためには、 MSX-DOS1 
でフォーマットしたフ〇 y ビーディスクに、 N1SXDOS.SYS と COMMAND.COM とをコビー 
'AUTOEXEC.BAT およびアプリケーションプログラムを作成（またはコビー> します。 

MSX-DOS2 で、 AUTOEXEC.BAT によリブログラムを起肋するためには、 MSX-DOS2 
でフマノトしたフロ；/ピーディスタに、 MSXDOS2.SYS と COMMAND2.COM とをコ 
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ピーし、 AUTOEXEC-BAT およびアブりケーシ a ンプログラムを作成（またはコビー）し 
ます。 


プートセクタによる立ち上げ 

MSX-DOS1 で、プートセクタによりブログラムを起®)するために tt、MSX-D0S1 でフォー 
マ/•卜したフロッピーディスクのブ-•トセクタの001 EH~00FFH に、アブ”ケーシヨンプ 
ログラムを琥み込んで其行させるプログラムを#き込みます。 

ft 初に、 001EH-00FFH に方 S 込まれたプログラムは、 0C01EH-0C0FFH に JS み込ま 
れキャリー7ラグを0にして3— ルされます。この時点では，ぺ•■ジ1を RAM に切9 
換えることができないので、ユーザープログラムの teU) には不通当です。次に、もう 1S 
MSX-DOS1 の15境下で、キャリー7ラグを1にしてコールされます，このとス〇ット 
の状想は以下のようになっています， 

ページ W 容 

0 RAM 

1 Disk ROM 

2 RAM 

3 RAM 


また、レジスタには以 F の情報が人っています。 

レジスタ内容 

A 0ならば電迪投入面後を尔す。 

DE この内容をコールするとページ1の DiskROM が RAM に切り換わる。 

HL デイスクエラー* S 理ルーチンへのポインタへのポインタ (MSX-Datapack 

Volume 1の第2部 7.9.3 『エラー処理 j 参照)。 


MSX-DOS2 で、ブートセクタによ9プログラムを起勒するためには、 MSX-DOS2 で7ォ_ 
マットしたフロッピーディスクのプートセクタの003 0H 〜 00FFH に，アプリケージ3ンブ 
ログラムを较み込んで•夫•行させるプログラムを書き込みます。 

Ai 初に、0030 H-OOFFH に*き込まれたプログラムは、 OC030H-0C0FFH に SE み込まれ 
キャ U —フラグを0にしてコールされます。この時点では、ページ1を RAM に切り換えるこ 
とができないので、ユーザーブログラムの起*には不;4 ’S です。次に、もう1度 MSX-DOS2 
の現境下で、キャり—7ラグを1にしてコールされます。そのときのスロットの状®やレジ 
スタの情報は、 MSX-DOS1 と同じです。 

MSX-DOS のブートシーケンスについての詳細は、 MSX-Datapack Volume 1の第3部 
3.1「MSX-DOS の起 lij か、 rMSX 2 テクニカルハンドプック j の P.97~98 を签照して下 
さい. 



，/ 7 トウ i T の起©！ 



4 フロッピーディスクの BASIC プログラム 

sk BASIC1.0 で、 BASIC ブ。グラムを起肋するためには、 MSX-D«S 1 でフマ 
たディスクに、 AIT 鲁 EXEC.BAS およびアプリケーシ3ンブ〇グラムを作成（また 
— >します， MSXDOSSYS と COMMAND COM とは人れてはいけません。 
nk HASIC 2.0 T, BASIC ブログラムを«种するためには、 MSX-DOS2 でフ * 

たテイスタに. AUTOEXEC.BAS およびアブ 1 )ケーシヨンブ u グラムを作成（また 
-) します。 MSXDOS2i5YS と C0MMAND2.COM とは人れてはいけません， 



4 章 

BASIC 


4.1 追加された命令 

MSXturboR では、 PCM 描能などが追加されたので、 BASIC でもそれらの機能が使え 
るよう、 CALL PAUSE、CALLPCMPLAY、CALL PCMREC 命令が追加されました， 
以下では、それぞれの命令について说明します • 

CALL PAUSE _ 

[檐能]指定された時明だけポーズします。 



[文例、 CALL PAUSE(IOOO) 1秒間ポーズ 

[解说 j 指定された時問だけ、 BASIC プ D グラムの実行を停止します。ポーズ時 

間の単•位はミり秒です。 CALL PAUSE 実行中は、 fl り込みは許可されて 
います， CALL PAUSE 実行中でも、 ICTRL) + fSTOPI キーでブログラ 
ムを中断することができます。 CPU の実行速度の釤饗を受けないタイミ 
ングをとるときに使います， 

CALL PCMPLAY _ 

[檐能 1 PCM 音を再生します。 

[畜式. CALL PCMPLAY(® 明始番地，終了 S 地，サンプリングレート） 

メイン RAM からの再生 

CALL PCMPLAY(@ 明始番地，終了番地，サンプリングレート， S) 

VRAM からの再生 

CALLPCMPLAY(K 月変数名，[長さ】，サンプ U ングレート） 

配列変数からの再生 
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「文例 1 CALL PCMPLAY(@&HBOOO, &HBFFF,1) 

メインメモリの &HBOOO 壽地 一&HBFFF 番地を PCM データとして再亇 
します，サンブリングレート« 7.875 KHz とします。 

[解扯丨 メイン RAM または VRAM の内容を PCM データとして，指： i された 
サンブリング坳波款で再生します。 


• サンプリングレート 
サンプリングレートを指定します。 



1 7.875 

2 6.25 

3 3.9375 


• fi さ 

«略できます。有咯したときは、配列変数の内容すべてを再生します。 

データの形式はアブソリュ ーI •パイナリで、 1-255 が通常のデータで 
す。0は特珠なデータで、0の後に«<1パイトで描定された间®分、0 
レベル (127) を出力します0 

[ft I Z80 モードのときには，に R800 モードに切り換えて実行し，終 

わると Z80 モート•に反ります。再生中に、 f§TOP】 キーが押されるとブ D 
グラムの实行を中断し、 BASIC に戻ります。 

MSX-BASIC では、 &H で表現できる16進数は &HOOOO-&HFFFF の4 
桁であることと、 &H 8000 -&HFFFF は負の数であることとに注意して 
T さい，これは，メイン RAM を指定する際には問«にはなりませんが 
VRAM を捎定するときには注®が必要です。例えば、 VRAM の後-‘!*の 
64KB を再生するには 

CALL PCMPLAY (865536,131071 ,2,8) 

のよ7に报定しなければなりません （131071=66536x 2-1), これを 
CALL PCMPUY(«kH10000 , ftHIFFFF, 2,S) 

と折定すると、 r Overflowj エラーにな9ます。また 

CALL PCHPLAY(04HFFFF+1 .ftHIFFFF X2+1,2, S) 

It . &HFFFF+1=-1+1=0 と fcWFFFx2+l>lx2+l=-l=icHFFFF と 
で. CALL PCHPLAY(a0,l£HFFFF,2,S) と同 tK なります。 



CALL PCMREC 

[檐能 | 音声を PCM» 身します。 

[丼式 I CALL PCMREC (◎期始 S 地，終7•番地，サンブリングレート[.[トリガレべ 
ルスイッチ II) メイン RAM への録音 

CALL PCMREC (◎開始 S 地,終I"番地.サ••■プリングレート，[トリガレべ 
ル j,| 圧梅スイッチ】， S) VRAM への録音 

CALL PCMREC (配列変 ft 名， 【fe さ],サンブリングレート（，[トリガレべ 
ル]圧梅スイッチ] I) E 列変数への録音 
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データの形式はアブソリ ユー トパイナリで、255が通常のデータで 
す。0レベル付近 026-128) のデータが2つ以1•.进较したと SU、 1>と 
その 迭続した W 数を^*することによって、 データを坧祐で#ます。 この 
If 梅を 無 S データ li: 箱と いいます。 

Z80 モードのと S には， fl 勒的に R800 モードに切り換えて •夫 行し、耔 
わると Z8U モードに 戾_) ます。また、 Z80 モードや R8II0ROM モードの 
ときに、サンプリ〆グレートを15.75 KHz I こ 街;5：すると、 r IUpgal funrt 1011 
callj エラーになリます。 itff 中に. IST0 内 キーが押されるとブログラム 
の*太むを中断し、 BASIC に W リます。 

VRAM へ»音するときは、 CALL PCMHLAY とうじょうに、指定する# 
地に fli$ して T さい。 

4.2 変更された命令 

MSX turbo R では、 MSX-D0S2 が埔电挤戴され、カセットインター 7i イが削除され 
たのて、77•イル名をパラメークとする命令の什栊が史わリました， 

以卩では、それぞれの命令について说明します。 

BLOAD/BSAVE/LOAD/MERGE/OPEN/ 

RUN/SAVE 


[W % I これらの命令で，フ7•イル名に 1 "CA&j を析定すると、 r Badmi’mwmM 

エラーになります。また、 MSX D0S2 で、ディスク77•イルを柑定する 
と5は、7アイル名を7ルパスで指定することができます。 


COPY/FILES/KILL/LFILES/NAME 

[W 说 ] MSX - D 0 S 2 に対) i しました。 MSX - D 0 S 2 を使っているときは、フ r イ 

ル名をフルパスで指定することができます。 



4.3 削除された命令 


MSXtuib* R では、カセ/トインターフ •* イスが削除されま 
セ •/ トテープ网迚の命令が削除されまし/二 
以卜では，それぞれの命令について说叫します。 

CLOAD/CSAVE/MOTOR 

[M d I i れらの命令を劣行すると、 r Syntaxcrroi 
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BIOS 


5.1 追加されたェントリ 

MSX turbo R では、 BIOS についても、 CPU の切り*んや PCM 明連のェントリなどが 
追加されています。 

以下では、それぞれのェントリについて说明します， 

5.1.1 CPU 切り換え 

CPU の切り換えの BIOS には、 CHGCPU と GETCPU といウェントリがあります。 

CHGCPU(0180H/MAIN) 


琅 5 9 BIOS 


CPU のモードを指定し*す， 
モード竞眛 
00 Z80 モート • 

01 R800 ROM モード 

10 R80«DRAM モード 


LED 

LED の状®を指定します。 

LED S 味 

〇 LED を変化させない 

1 LED を変化させる 


\ K 0 ffl] なし 

映®レジスタ] なし 

|解说| A レジスタの内转によって， CPU を切り換えます，もし， A レジスタの 

ビット7が1なら、変史した CPU にあわせて、 CPU の状怒を表す LED 
を変化（点灯するか if (灯するか）させます • A レジスタのビット7が0な 
ら、 LED を変化させません， 

*逬的の CPU のレジスタの内！#は、 R レジスタ以外は、変史後の CPU に 
受け継がれます，变®後は.込みは許可されます。 

[it a ： I cpu の切り換えは、システムコントロール lsi (si99o> 内の aa を'；*: 

えるだけです。そのため、 Z80 や R800 ROM モードに切り換えた後，« 
いた DRAM エリアの内容を方き換えて、 R800 DRAM モード1こすると 
システムは&走します。 DRAM へのシステムソフトウエアの*！;送は、シ 
ステム起動時にのみ行っています。 



GETCPU(0183H/MAIN) 


J0ft, どちらの CPU が袖 f1:L ているかを洱ベます 


ル手順 j なし 

[戾9依1 A 

to 4味 

0 Z80 モード 

1 R800 ROM モード 

2 R800 DRAM モー 


F 


5.1.2 PCM 

PCM データの . 办牛の BIOS には、 PCMWjY と 
ます. 


PCMPLY(0186H/MAIN) 

[棰能] PCM のデータを冉生します。 


丨コール午 I® A 

b7 b6 b5 M b3 b2 bl IX) 
厂 R , 。 | 。 j 0 丨 P 丨 。 | S 丨 S | 
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サンブリングレート &味 （KHz) 
00 15.75 

01 7 875 

10 5.25 

11 3 9375 


再士するデータをおくメモリをします。 
メモリ &味 
0 メインメモリ 

1 VRAM 


HL PCM データのアドレス 

VRAVHS2； 時は、 E レジスタと HL レジスタとをあわせて、 
3パイトで K 定します。 E レジスタが*上位パイトです。 

BC PCM データの长5 

VRAM 指定時は、 D レジスタと BC レジスタとをあわせて 
3パイトで设定します • D レジスタが最上位バイトです， 


[* 0 ffi] キヤ y —7ラグ 


UK S 味 

〇 正常終了 

1 異常終了 

A 

異常終了要因 


1サンプリング周波数指定 K0 

2 [STOPI キーによる中断 

HI, 

中断時のデータアト*レス 

VRAMtS 定時は、 E レジスタと HL レジスタ 
とをあわせて、3パイ1•で返します。 E レジス 
夕が K 上位パイ（•です。 



隹£レジスタ！ すべて 

I注怠 I Z80 モー 1 1 めと jl :は.自動的に R800 ROM モ•■•ドに切り換えて突行 

し、終わる 7；S0 _ ■-ドに反ります， 

PCM を再3してレ■あ K は，刺り込みは禁止されます，なお， 1STOPI 
キーが押さ: i ると i _ i ■を♦析します。 

この BIOSU, 実屬 -； は-«—ジ1 <04000H~07FFFID におかれたブログ 
ラムで实行 I れま f し*;:がって、データをメインメモリにおくときは， 
必ず0800011番地 J1 1で知ければな9ません， 


PCMREC(0189H/MAIN) 


楢能 I 


PCM のデータを ftiV します。 


[コール手!^] 


A 


b7 b6 b5 bl b3 b2 bl bO 
I R 1 T I Ti t ； T fc fs I S I 




サンブ i) ングレ--卜 
汗綰 

(• 1 )ガーレペル 
VRAM/ メインメモリ 


サンブリングレ-•卜 
サンブリングレ-卜を指定します。 
サンプリングレート意味 （KHz) 
00 15.75 

01 7.875 

10 5.25 

11 _ 3.9375 

圧縮 

庄龙するかしないかを指定します。 

FEMI _ 

0 1£箱しない 

1 圧路する 
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•トリガ -- レペル 

»&の S つかけとなる音の大きさを指；5：します， 
• メモり 

»(! するメモリを指定します. 

メモリ窓咏 
〇 メインメモリ 

1 VRAM 


HL PCM データのアドレス 

VRAM1S 定時は、 E レジスタと H1, レシスタとをあわせて， 
3パイトで攻定しまする E レジスタが ItH ■•位パイトです。 

BC PCM データの ft さ 

VRAXMS 定時は、 D レジスタと BC レジスタとをあわせて 
3パイトで as します。 D レジスタが W |--位バイトです。 

[re 〇 ia] キヤ ij — 1 ? ラグ 


W 

T" 


s 味 
iT 常終了 
灭常終了 


A 


與常終了要 W 


1サンプリ 
2 ISTOP] 


ング ra 波致指定»リ 
キーによる中断 


HL 中断時のデータアドレス 

VRAM 指; i 時は、 E レジスタと HL レジスタ 
とをあわせて、3バイ1•で指定します。 E レジ 
スタが «t 上位パイトです- 


^ fc® レジスタ I すべて 

I tt 意丨 Z80 モードのときには、 ft® 的に R800 ROM モート•に切り換えて尖 h" 
し. ft ■わると Z80 モードに戻ります。 

Z80 モードや R800ROM モードのときに、サンブリングレートを1575 KHz 
に指4すると、 1 ■サンプリング尚波我栴定 KiJj エラーになリます。 

中 U, H リ込み (i 结 ii. され.ます。なお， I STOPl キーが押されると其 h を 




圧 IS 

IVL 時に (i 、常にデータは U： 相 5ii ている t の t 兒なして再屯し i す. 

には、正縮スイッチにより reito 輝の葙無を指定できます，ただし、》疗デー 
夕が〇のときは、常に1に鞔みかえて纪銶します》 


5.2 変更されたエントリ 

MSX turbo R の让«により、内容が変わったエントリ fc あります。 

以ドでは，それぞれについて変1¢された点を说明します* 

GTPDL(OODEH/MAIN) _ 

[樯能I パドル櫟能はなくなりました • 常に〇が返されます《 

TAPION(OOE1H/MAIN) _ 

[擓能1 常にキャり'-フラグを >y •て，エラーとしてリターンします。 

TAPIN(00E4H/MAIN) 

[檐能I 常にキャりーフラグを立て、エラーとして 1 j ターンします。 

TAPIOF(OOE7H/MAIN) 

I楢能1 常にキャリーフラグを立て、エラーとしてリターンします。 

TAPOON(OOEAH/MAIN) 
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TAPOUT(OOEDH/MAIN) 

['嫌 能丨 常にキャリーフラグを 守. て，エラーとしてリターンします。 

TAPOOF(OOFOH/MAIN) 

[械能I 常:にキャリー7ラグを立て，エラーとしてリターンします， 

STMOTR(OOF3H/MAIN) 

[捩能]何もせずに y 夕_ンします。 

GTPAD(OODBH/MAIN) 

[拽能丨 ライトペン裱能はなくなりました 0 A レジスタに8~11を人れてコールす 
ると、常に0が通されます。 

NEWPAD(01ADH/SUB) 

[拽能丨 ライトペン槻能はなくなりました • A レジスタに 8-11 を入れてコールす 
ると、 ft •に0が&されます。 

RDRES(017AH/MAIN) 

「楢能1 システムチ約です。 

WRRES(017DH/MAIN) 

[機能]システム予約です。 



6 章 

マツノヽ °— RAM セグメント 


ここでは、 R800 DRAM モードでシステムセグメントに割り付けられた、マッパー RAM 
セグメントを再利用するための手期を招介します- 


6.1 MSX turbo R の マツ パーサボートルーチン 

MSX turbo R のマツパーサボートルーチンは、 R800 DRAM モー•ドを考慮して、以下の 
ように拉張されています。 

1. 常に、内蔵スロット上のマッバ ーRAM をプライマりマツパーとして»択します。 

2. プライマリマツバー RAM の最後の4セグメントを、 R800 DRAM モード用のセグメ 
ントとして®Iり付けます。 

3. HIT D0S2 力一冬ルの RAM セグメントは、 R800DRAM モード用セグメントの前 
の2セグメントに割 1 )付けます， 

マツ/ー サボートルーチンでは、 R800 DRAM モードであるかどうかに 明 わらず、実際に 
システムに実装されている RAM 容 fi をもとにして、管埋するブライマリマツパーの総セグ 
メント数を決めていることに注 S して下さい • 

本体の RAM が 256KB の場合、初期化が終わった段 K では、荆り付けテーブルは以下の 
ようになります。 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

「S I S「S [S I - 卜 1 -~1 - I 二 I' 「 s |~s fs fs 「s Ts 1 

図 1.3 初期化時の割り付けテープル 

ここで、 FT] とあるのは、「システムセグメントとして割り当てられてい Sj という*味 
で内訳は:欠のとおりです。 


笫 6 ? マソパー RAM セグメント 


$1 1.4 初期化時のシステムセグメント 


セグメント#号内容 

0~3 アプリケーションが使用する。 

10-11 MSX-DOS2 カーネルが使用する。 

12-15 袖り当てられているが、 MSX-DOS2 で U 使川しない • 


この状®ではセグメント4~9が拥リ付けの対 ft になリます。 

R8M DRAM モードのと S, M 後の4セグメントはライトプ〇テク！•されておリ、 RAM 
としてアクセスできないので，マツパーサボートルーチンが‘返す総セグメント数のうちの4 
セグメントは， RAM として扱うことはできません。しかし、セグメント管理の立場からは 
この4セグメントはシステムセグメントとして*110付けられており.アプリケーン a ンに対 
する剌リ付けの対象にならないので，文質上の弊•也はありません- 

後¢0 4セグメントには、システムの初期化時に、システム ROM の内界がコビーされて 
います。 ft セグメントにコピーされる ROM の内稃は以ドのとおりです。 


表 1.5 コピーされる•✓ステム ROM の内容 


セグメント* 5} 内容 

12 MAIN ROM (ぺージ 

13 MAIN ROM (ぺージ1> 

14 SUB ROM 

15 灌字ドライパの 16KB 


どのような場•にも，これらの4セグメントは} B にマツ/*—サボートルーチンが管理して 
いるので R80« ROM モードの坳会には、棵準的な手順の 1 ■セグメントの Wttj ファンク 
シ3ンを使って、解放することができます。解放されたセグメントは，以降「セグメントの 
削リ付け j 7ァンク zs ンの対象になるので、 RAM を冇効に使うことができます，以上の 
ように、マッハ•ー サボートルーチンは、 R800 ROM モードに切り换えた際に、必要に応じて 
ft 後の4セグメントを RAM セグメントとして再利用できるよつな構成になっています。 

ただし、12~15のセグメントをアブりケーシ a ンなどで使用したときは、 R800 DRAM 
モードに変えることはできません。どうしても R8i0 DRAM モードに! CB£ したいときは、シ 
ステム ROM の IM 枚を、表 1.5 で示したセグメントに3ビーし、それらのセグメントをシス 
テムセグメントとして荆リ付けてからにして下さい。 



6 2 to 後の 4 セグメント利用の手* 


6.2 最後の4セグメント利用の手順 

以ドで、 ® 後のセグメントを抖利用するための、具泳的な t 期を说明します。 

1. R80O DRAM モードであることを確涊します。 

ft 後の4セグメントが初期化 S れたままの状想であり、他の H 的で解放または再刮リ 
付けされていないことを# S しなければなりません， 

2. 拍 K BIOS の》■マ 7 パーサボートルーチンアドレスの ffiWj フアンクシ3ンを使って、 
ブライマリマッパーの総セグメント数を得ます。 

後の4セグメントのセグメント*衿を® W します。総セグメント数を N とすると 
IN 4)~(W-1) が解放の対 ft となるセグメントです。 

3-マソパサ，ボートルーチンの FRE5EG ファンクションを使って後の4セグメントを 
解放します。 

この際、 W 象となるのはプライマリマツパ_なので、 B レジスタ li ■です。 


63 プログラム例 


ブログラム例を以下に示します。この例では、エラー Jiff. や例外状®の判別は K 
なっていませんのでご注 JE 卜•さい。また、 junp-tabl •は RAM 〖•.にな•ければな 
リません. 




pop 

djnr 

junp- 

all_s 








:を I •-げるため、161定アドレスにジャンプテー 
;ブルをコビーする。 

;A - *-1 H-2 .... N-4 

:プライマリマッパーのセグメント [« を解放 







新しいハードウエア 


557 £ 折しい 







Oe6h ;カウンタ下位8ビ •/ 卜 

0e7h :々ウンタI位8ビット 



vait: 

in 

Id 

walt.loop: 


a,(countlou) ; カウンタの現在 W を? *f る 

c,a ; それを保存する 

a , (countlov) j カウンタの祝在.値を得る 

c :経; ftW ' ra を〇•出する 

b •• 指定された wm 拿 sa したか？ 

c wait.loop ;経過していなけれはルーブする 


7.2 PCM 

ここでは、 POl の I/O ポートや》皆 * 再生の手 W などを解说します。 

7.2.1 PCM の I/O ボート 

PCM »音 • 再*のための I/O ボート (itt 下のとお 1 )です. 

& 1.7PCM の I/O ボート 

备地 bitr bit6 bits bit4 bits 

0A5H(Wnte) 0 0 0 SMPL SEL 

OASH(Read) COMP 0 0 S.MPL SEL 

0A4H(Wrhe) DA7 DA6 DAS DA4 DA3 

0A4H(Read) 0 0 0 0 0 


bit2 _Wtl _ hitO _ 
FILT MUTE ADDA 

F1LT MUTE BUFF 

DA2 DAI DAO 

0 CT1 CTO 


ADDA (BtFF) バッファそード 


D/A 3 ンバータの出力をンングルパツフ Tt するか、ダプル ■»< ッ 
フ T にするかを指定します， D/A 時にはダブルバッファに、 A/D 
時に li シングルパッ71■にして下さい， 




7.2 PCM 


MUTE ミューティング MW 

システム全体の A 卉出力を OA/OFF します， 

0 fffSfli 力 OFF (リセット II.V) 

1 B»a 出力 OM 

FILT サンプル • ホールト-回路人力馆号の迸択 

A/D 時にサンブル•ホールド回路に入力する倍ち-を、フイルタの出 
力にするか、号 (ground level) にするかを選択します。 

0基! M 付（リセット時) 

1フィルタ m 力 w 咢 
SEL フィルタ人力估 y- の道択 

口ーパスフィルタに入力する号を、 D/A コンパ_夕の MJJjK 号 
にするか，マイクアンブの m 力 tiy- にするかを逆択します • 

0 D/A a ンパータ m 力 fe 号（リセット》々> 

1マイクアンプ出力 if; V 
SNIPL サンプルホ-ルド信号 

人力保兮をサンブルするか、ホールドするかを进択します。 

0 サンプル時（リセット時） 

1ホールド時 

A/DRH こは、信号をホール1■•する齣に、 ® 低ろ/むはサンブルしな 
ければなりません。 

COMP コンパレータの出力付号 

サンプル.ホールドの flUjfe 好と、 D/A コンパータの出力但好と 
をくらベて，どちらが大きいかを KA 出すことがてきます。 

0 D/A ft 力〉サンプル..ホールド出幻 
1 D/A 出力 < サンプル，ホールト•出力 
DA7-DA0 D/A 出カデータ 

CT1.CT0 * ウンタデータ 

63.5/1 秒ごとにカウントアップされます。 

D/A 時 （ADDA が1> K«, * ウントアップに时期して、 0A4H 拆 
地に古かれたデータが繰り返し出力されます。 0A4H 番地にデータ 
を？ f き込むと、カウンタはクリアされます。 

A/D 時 （ADDA が0> には， 0A4H S 地に咨かれたデータはすぐ 
に出力されます。 0A4H 番地にデータを#き込んでもカウンタはク 
リアされません。 



* 7i? ■析しいハート•ウェア 


7.2.2 PCM 再生 
PCM は次の T 順で冉生します。 

1. ADDA を1に、 MUTE を1に. SEL を0にします (I/O ボー トの OAr>H 番地に 
HOOtOOOllB を出力する)。 

2. CT1,CTO を成んで、サンプリング周期を検出します。 

3. PCM データを出わします • この!：き、カウンタは自助的にクリアされます， 

4. データの制数凹、2と3とを提り返します¬ 


- z80 


PCM 再生 

人力 HL • PCM データの冊始アドレス 
BC - PCH データの K さ 
E »«キ•サンプリング尚期 

1 15.75 KHz 

2 7.875 KHz 

3 5.25 KHz 

■ROft なし 


pcncntl equ 





r 

inc 

dec 

Id 

jr 



;D/A 3 ンパータ （Write) 

; カウンタ （Read) 

sk 

;PCH コント ロ _ ル (Write) 
i PCM ステータス （Read) 

a, 000000 lib 
(pcmcntl).a 

；D/A モードに: S 定 
; タイミングの正確さのために 
:刻り込みを禁止する 

a.Chi) 

; S 望の (A になったか？ 

: 4 つでなならループする 
；データを进み取る 

Cpcmdac) a 

: d * c に m 力する 
:次のデータを析し示す 
；カウンタを減らす 
j カウンタは0か？ 


nz,pcmplay_loop ; そうでないならループする 
:糾リ込み S 止を解除 






PCMttff は次の手啪で行います • 


1. ADDA を0に、 M1ITF を0に、 FILT を1に， SEL を1に、 SMPL を0にします <1/0 
ポートの 0A5H 番地に0000 U0UB を出力して、人カアナログ fe 号•をサンブルする> • 

2. CT1、CT0 を«んで，サンプリング B! 期を梭出します。 

3. «诋7/<秒抒ちます•この 7" 抄が2に含まれていれば f.? つ必费はありません， 

4. SMPL をIにして （1/0 ポートの 0A5H# 地に0001110 0B を出力する）、人カアナロ 
グをホールドします。 

5. 遂次変換のンーケンスによって、 D/A コンバータのヂータを1-.位ビッI•から変化させ 
ながら、 D/A コンバータ出力と人カアナログ信«•との比«結: R を COMP から拂み込 
んで、 ft ビ:/卜を決定し、データを格納します。 

6. SMPL を0にします （I/O ボートの 0A5H 番地に0000110 0B を出力する）。 

7. 2から6を級リ也します。 


• PCH データの fc さ 
=再生サンプリング尚期 

1 15.75 KHz 

2 7.87SKHZ 

3 5 25 KHz 




pcmstat equ oaSh 
T1 ビット i/D 変換"？ク D 


D/A コ 
* ウン 




データ 
PCMST/ 
フラグ 


iTAT からデータを3£み込み 


aange ;入カアナログ 
;データはそのまま 
strip ;入カアナ n グ信号の方が小さいので 

:ビットを〇にする 









アブ 1 )ケーション作成上の注意 


MSX turbo R で，アプリケーシ a ンプ〇グラムを作成するときは、以下の点に比®して 

TS い。 

8.1 MAIN ROM のバージョン番号 


MA1JJROM の 002DH 番地に人っているシステム (BASIC) のパ'-ジ3ン番号は以下の 
とおりです。 


機穫 

MSX 


MSXj 

MSXj+ 

MSX turbo R 


表 1.8 MAIN ROM のパージ 3 ン*磉 


BASIC のパージョン»号 
BASIC l.xx 


BASIC 2.xx 
BASIC 3.xx 
BASIC 4.xx 


002DH if 地の内容 


MSX turbo R であるかどうかは、 MAIN ROM の 002DH の内容が， 03H 以上 であ 
るかどうか（23> で利断して下3い。決して、3であるかどうか (=3) で典べてはいけま 
せん， 


8.2 MSX 2+ および MSX turbo R で動作するソフトウェア 


系 8 获アブリケーン3ン作®Iの注® 


ただし.このアプリケーシ3ンが MSX DOS1 のフ r ンクシヨンを呼び出すときに li» CPU 
を Z80 に切り換えてから呼び出すようにして下さい。 MSX »OSl は R800 のスビードに対 
応していないので、 R800 で MSX D 寿 S1 のファ/クシ3ンを‘/; ft すると、フ r イルを壊し 
てしまう -f 能性があります。 

また，基本的に：のようなアブリケーシ3ンは、 MSX-DOS1 や BASIC の：!マンド fj ち 
の状想に返ってはいけません。 RBOO t MSX-DOS1 とを HI み0•わせたと3の* W は、保証 
されていません。どうしてもアブリケー><3〆を終了したいときには、 MAIN ROM の〇番 
地にジャンプして f さい。 MSX UOS1 や BASIC のコマンド待ちに班ることが必 S なアブ 
リケージ3ンは、 K ったときには必ず Z80 が選択されているようにしてドさい， 

Z80 は IX. IY レジスタの8ビットアクセスを保訨していませんが、これを使用している 
V 7トウ x アが多くみられます。 R800 ではこれを保証しているので間題はありませんが、以 
下のような保合に Z80 とは光なった IA 作をします。 

例之ば 

LB IXH IXL 

に対する正しいオブジェクトは ■■ 65ですが、アセンブラによっては， DDDDfiS とい 
うオブジェクトをり成するものがあります • 

このオプジ * タトは Z80 では«»に iT しく «作するようですが、 R8*0 では勘作が保址さ 
れていません，I•分にご>1；这ドさい， 








MSX-D0S2 とは 


コマンド行の編集 


MSX-DOS においてコマンド行で人力を行う*合には人カミXの訂正や以前のコマン 
ドの再入力および ai* といった、面咕な編 Jt 棰能が使用できます。キーボードで通常の文字 
を入力すると、それらの文字はそのまま画面上に表示されます。大部分のコントロール文宇 
を入力すると、それらは r~j K 号に**くコントロ_ル文字によって表現されます，例えば 
fCTRLI + IA^ と表示？れます • 例外は、以下のコントロール文字です <■ 


表 2.1 コントロール文字 



Icmj + |MJ. ' l vf 


I CTRL； + d). iM) 

「CTRL I + 迅 fTAB) 
fcm] ♦因. 「IMS | 


[CTHLl + [T). |ESC| 

I CTRL! + (X). [SELECT 1 
(CTRL： + 0, (HOME) 

「cmi + 回 


機能 

コマンドの荚行を明始します，コマンド行の入力.編集が 
宪了したときに押します， 

々ーソルのすぐ左にある文宇を削除することがで5ます。 
コマンド行で入力していると S はいつでも使うことがで S 
ます。 

タブ 

•■上耆モード J と「禅人モー pj を切り換えます-上耆モー 
ドのと 5、 カーソルの形状はI文字分の大きさの矩形で 
入力された文字はカーソルの下にある文字を S ねしま 
す。挿入モ—ドのとき，力ーソルの形状は1文字の竿分の 
大きさの »i 彩で、入力された文字は*-■ソルの前に神入さ 
れます《 

行をクリアし、新しい行の入力ができるようにします。 


冷ーソルを行の光頭に移肋します • 

ブレ_クキーとして梭能します，より効果的で望ましいプ 
レークキーは ICIBLl + (STOP) です。 



m キー 

+ ぼ 


檐能 

&行コ --K ですが，コマンド〇で人力されたときは何もお 


きません。 


fern + l*J ICTRLl ♦ (?) によってオンにされ A； ブリンクエコーをオフ 


にします。 

fCTRL； + (D ブリンタエコーをオンにします。オンにすると、内而 h に 

表示されるすべての文字がプリV夕にも送られます。 


fCTBLI ♦ _ 他のキーが押されるまで、すべての文卞の出力を停 1L します， 

「CTRL| ♦ f0| 現在人力屮の行を SK 去します. 


その他の fSIfe 故能は以ドのとおり です. 



表 2.2 feJtfil 能 

抟殊キー 

拽能 

■ DEL) 

❖-ソルの K にある文+•を削松します • 

BE 

力ーソルを行の中で左ム•に移 j) (させます。 

ソル移*) J 後に文卞を人力すると、 t •.省きモードの M は.その時点で 
々ーソルの下にある文卞に》ね#きし、神入モードの時は.その《??点で 
令ーソルの前に人力した文字が神人されます。 


また、3マン1••行エディタのりスト«以前に入力されたコマ〆|••のストを fti 大256 + 文卞 
まで保存してぃます， 〔tl キーを押すと，その 1 )ストをさかのぼって，以明に人力されたコ 
マンド行が表; R され，このコマンド行をしたリ冉入力したりすることができるようにな 
ります。同枝に、 UJ キーを押すと、その次に人力された 3 マント*行に移®)します。 

以前のコマン！ *Tf が変 E されると、それは新い、コマンド行として、りストの ft 後に迫加 



ノ、'-ジョンアップにともなう変更点 


MSX-DOS2 は H 度か拡强、改良され現在次のようなのパージョ〆があります。 


% 2Z MSX DOS2 のバージ3ン 


パ_ジ3ン番婷 内容 

MSX DOS veraion 2.20 日本 »MSX-DOS2 ( アスキー*売） 

2.30 MSX turbo R FS A1ST (Panasonic C!) 内蔵 

_ 2.31 MSXturbo R FS-AIGT (Panasonic*!!) 内® 

VER コマンドにより、現在お使いの MSX-DOS2 のバージ a ンを嫌18することができます。 
また、ネルム r MSXDOS2.SYSj, r COMMAND2.COMj のパージ3ンはそれぞれ 
M なっていても使用できます。 

この蕈で11、パージ*ンアップにより拡張した棰能について说明します。 


3.1 version 2.30 の新機能 


«%* 数 KHELP を迫加しました， HELP 3 マンド突 tTW •に、画 ifii モードに.必じて 
ANK モードならば HELP で指： i されるディレクトりを、浼字モードならば KHELP 
て梢定されるディレクトリを 6IJ 的に迸択します，それぞれデフォルトは MSX-DOS2 
が fiM されたドライブのルートディレクトリ中の HELP、KHELP というディレクト 
りになっています • 

15境変 S EXPERT を追加しました。 EXPERT は MSX-DOS1 でフォーマットされた 
ディスク h のプログラムを尖行させるかさせないかを制 W します • これは MSX-DOS 
のバージョンの; a いからくる！ snsfl を未然に防ぐために追加しました， r oNj 以外の姐は 
すべて r OFFj として解釈します- EXPERT が存&しない（デ7ォルト）か r OFFj 
の坳介は MSX-DOS1 でフォーマットされたディスクからのプログラムの案行は»止 
されます。この場介、次のようなブ d ンブトが川力されます • 





a. シフト立ち上げのとき、 (3 キーが枰されていなければモード 

b. 0キーが押されていれば Z80+MSX-DOS1 

c. H.STKE がセットされていたとき 
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jsiaan path の内好を ^i； します。 

• コマンド IF を追加しました。 



MSX-D0S2 への移植の注意 


この章では、 MSX-D0S1 上でブログラムを作成する実力を待った方を対象にして、 MSX 
D0S2 の榆能を十分に生かしたプログラムを作る R の注*点について解说します- 


4.1 フアイルハンドルの利用 


77■イル K アクセスするには、 MSX-DOS1 のときには FCB を使いましたが， MSX-D0S2 
ではこの他にファイルハンドルを使うことが可能です • ファイルハンドルを使ったアクセス 
には以下のような利点があ •） ますので、これを便うことを強くお奨めします。 

1. カレン！•デイレクトリ以外の7 7■イルを扱える。 

2. FCB を保持するには37パイト必要だが、ファイルハンドルを保持するには1パイト 

でよい. 

3. 77■イル名を r 8 バイトの主7アイル名と3パイトの拡*子 j に整形する必要がない， 


従来の FCB を使ったフアイル I/O (ね以下のような手順を®んでいました。 


: MSX-DOS2 への移 M の汴尨 


これに対してフ7•イルハンドルを使った1/0は以下のようになります。 

r パス名 （ASCHZ 义す•列:ヌル文字で終/■する文字}を用尨する， 

2' .OPEN (013H) または CREATE (044H) をけんでハンドル番号をもらう， 

4' .SEEK (04AH) を呼んで® t みたい•普きたいバイトの所へ移勋する。 

O' JIEA» • AVRJTE (048H - 049 H) を呼ぶ。 

7’ .CLOSE (045H) を呷ぶ。 

ファイルハンドルを使つ場合は3,や!5’はなくなっています。これは、ブ〇ックサイズは 
1に W 定され、転送アドレスは -READ、-WRITE 時に指定されるためです。 

FCB による1/0と速って、ファイル名は8+3のフォーマットに SI す必定はありません„ 
またファイルハンドルを枒たら以後パス名は小典です，ブ〇グラム U ファイルハンドル*号 
(1 パイ！ •> だけを Kit していれば，その後の»琿ができるようになっています， 

ASCHZ で卉かれたファイル名を8+3のフォーマットに女換するには- PFILE (05CH) が 
f!E 利です • 1 ■■ム r ..j や*'* j などの扱いも行います。 

個々のファンクシ3ンの詳細は、 17.3 •■ファンクン3ンの说叫」を参照して下さい。 

4.2 漢字を扱う際の注意点 

灌卞の内部龙祝はシフト JIS です。シフト JISU®1 パイトが 080H-09FH 0E0H-0FCH 
で、 ®2 パイトが 04(>H~07EH、 080 H-0FCH の範岡にあります。注念しなければならない 
のは®2パイトが、他の1パイトコ-ド <040H~07EH、OAOH-ODFH) や茁字の第1パイ 
卜の範 M と ffi なっていることです。その結果、1パイトを免ただけでは、それがどんな文字 
か判らないということにな9ます。 

00H-D3FH, および 07FH は、漢 t の第1バイト、» 2パイトのどちらとも*なっていな 
いので、丨パイト兄ただけで漢字ではないと W 断できます-しかし、それ以外の場合は*字 
かどうかを判別することはできません， 

っまり、どんな文卞かを知るためには、 0OH~03FH、07FH が兒っかったところから、陬番 
にチIックしていかなければなりません，例之ば漠字テキストフ r イルのある場所からファイ 
ルの-先通に向かって、ある文字を検索する，などの作龙は決して簡事なものではありません， 

単に現&のスクリーンモードが ANK モードか漫字モードかをる1こ«、拉張 BIOS コー 
ルを使います。 A = a D=011H E=0 にして OFFCAH を呼び、 A=0 て•戾ってきたら ANK 
モードです。たた•し、このとき SP はぺージ1以外になければなりません。 

文字の®性などを38ベるには- CHKCHR <05DH) のファンクシ3ン3-ルを使います，凋 
ベる文字列内の A 字を*®にこのフ T ンクシ3ンに跄すことによ0、文宇の桟頚を判別でき 
ます。 ANK モードか} "K 字モードかの M 断は、この7ァンクシ3ンの中で打われるので、呼 
ぴ出す彻!はモードを湃ぺる必 Sf がありません。 

茂字を ft むパス名やファイル？;を解析するのには _PARSE (05BH)、_PFILE (05CH) を 
使います。漢卞の第2パイトが r ¥j (05CH) である場合でも、この 7T ンクシ3〆が適 VJ 




な処押をけいます。 ANK モードか <• 史字モードかの’判断は，このファンクンヨンの中でむわ 
れるので 《f ひ出す棚はモードを典べる必定がありません， 

4.3 I / O コントロールの利用 

アフりケーシ3ンによっては、スクリーンのサイズや、出乃がスクリーンにいくのか7 y 
イルまたはデパイスにいくのかが問組になる場合があります。 JOCTL (04BI1) はこのため 
の77•ンクシ3ンで、今まで (IF3B0H (UN1-EN) を} i て Witt していたプ〇グラムは、この 
7r ンクン3ンを使うように变 Sl£ する Ct が罕ましいでしょう， 


4.4 環境変数の利用 

アフリケーションによっては、 sa« 変&を使うことによって找作 tt や«；能が大«に•.する 
ものがあります。例之ばテンポラリファイルを作成するディレクトりの指定などがあります • 
S! 境変我を扱うフアンクシ3ンには、 .C5ENV (06BII), .SENV (06CH), .FENV (06DH) 
が* IJ ます. 

それ H W •はアプリケーシヨ✓から iff 极 M 之る糾!1にはなく、冷ーネルのテ•ータセ 
グメントにあります，これ b のファンク vs ンは、 SJift 変 ft とアブリケーシヨン空 Wit の檐 
A しをするものです。 



5 章 

n マンド 


この章は MSX DOS2 に樣挲で含まれるすべてのコマンドを#拥1こ说明します，それぞれ 
のコマンドは表記法にしたがって说明します。 


5.1 この章の表記法 

MSX-DOS で利用できるコマンドの«文の说明には、以 T のような衣紀法を使用して说叫 
します- 

• 大文字の卑語 

キーワードであり、示されたとお9に入力しなければなりません，しかし、大文字•小 
文字は区別されないので、これらを«ぜて使用してもかまいません， 

• B 本語の項目 

コマンド行中のその位 a でコマンドに与えなければならないパラメ-•夕です。 

• 角形かっこ （[!> で囲まれた項 H 

苗略 w 能な項 B です，角肜かっこ自体をコマンド行に含めてはいけません。 

•保持（丨> で区切られた項0 

項 B のうちひとつを選択する必要があることを示します-战棒自体はコマンド行に含 
めてはいけません， 


梓で M まれたテキスト 


内面の*示例であることを示します • 


以下に示すのは、コマンド行上に指定することのできる項目です。 


第 ft ft 3 マンド 


•t 

ドライブ名が必要であることを示します <A:、B ••など >• 

<レか苒略" J 能であるとき、衍•足されなければ々レントドライプが使《|されます 0 々レン 
トトライブは、コマンドアロンブトによって/八？れます。 


• ><X 

デ■(レクトリバス名が必要であることを求し，その捵文は MS DOS のものと ISJtt： で 
す。パス名中のそれぞれのディレクトりは r ¥j si：y ■によ：>て14切られます„パス名の 
先！ SU 二 「¥j 此号がある場合はパス名がルートディレクトりから始まることを示し，そ 
うでない場合は、パス名は CHDIR コマンドによって小されるカレントディレクト” 
から始まることを示しま ■ フ T イル名がバス名の後に软く場合は.パス？;とフアイ 
ル名は r ¥j iS けによって R 切なければな U ません。2つの連技した！••ット 1 \.j は 
パス名中ですぐ上の親ディレクトリを衣します • V—のドット r .j はパX名中でカレ 
ントディレクトリを衣し、したがってそれはI治*パス名指定において«の盎眛も持ち 
ません。 

海外 ff 様の MSX マシンて•は》パス? ViOf ズ切リ記好は r ¥j ではなぐパックスラッシュ 
( r \j) が衣/ r、 されます。 

方式でパス名が省略<能としてボされ、指; i され■なかった場介には、カレントディレ 
クト IJ が使出されます。カレントディレクトりは、 CHD1R コマンドでポされます。 
パス名を«成するデイレクトリ名の«文は、以下に； R されるフ7•イル？;の桷文にした 
がいます， 


ファイル名 

ファイルの «m が必 3J なことを小します • 

フ7■イル f ■は UT の構义をとります。この桷文は MS DOS および XISX-DOS1 と Wft 
です. 


•t: ファイル#; |.«：jB7] 


ここでキ-フ r イル名とは8文 t: までの文卞列であり、拡® T は3文 T までの文字列で 
す，この制限を超える文字はすべて Sffi? れます。 +.7 7■イル名または强子の中で 
ワイルドカード文字を使うことができます。 


<7イルドカード t は77•イル名を指定する除に、任 .<£ の1宇または文卞列に対応して 
その文すまたは文す列の代わりに用いることかできる«略 sey のことです. 

7イルドカード文•ネを ra いると、ファイルを指 i する際にいくつかのファイルをまと 
めて指定することができます。 

ワイルト々ード文字には、任怠の1文卞に対応する 「?j (クエスチョンマーク）と ft 
总の文—? 1 列に対 IS する 1 ■本 J (アスタリスク）の2 « M があります。 
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拡*+を 1 j える場 ft ■には、それは1つのピリオド r j によっても7ァイル名の部分か 
ら区切らなければな _) ません。以ドの文字は7 7•イル？；の屮で使用することはできま 
せん。 


コント〇-ルコー！'•および SPACE (文字；ド 0 H -20 H および 7 FH 、 FFH ) 

: i • . = + V < > | / " [ | 

ファイル名としてリ•えられた文字は大文卞に変換されます。したがって大文字と小文 
字は N じ&味を持つことにな I )ます • 2バイトの K 卞コ-•ド（シ7卜 JIS コード > を使 
用することもできます。 

7アイル«か可姥である場合■にそれが折3!されないと、 7r イル r, r *.*j が使 W 
され■ます。 


フ7■イルスペック 

これは、ディスク I ••の PI —のデイレクトリ中の W 定のファイルあるいはいくつかの7ァ 

イルを雄別するために使川されます，格文を次に示します。 

[ d : l [パス1[ファイル名1 

ここで、3つの K 略可能な項□のうち Ai 低ひとつは枏;£3れなければなりません，これ 
が17灰するフ t イルを列肀するため使用される埃介には、 / H スイッチを衍定すること 
で不"]■枚•フ7■イルを龕别することができます。 

一般に， d : が ffiS ； されないと現在のカレントドライブが使用され、パスが析定されな 
いとそのドライブの々レントデイレクトりが使用され、ファイル名が柄定されないと 
7 T イル名 r *.* j が後川されます。 


«合7ァイルスペック 

これは、コマンドが通用される7ァイルやディレクトリを枏定するために使用されま 
す。栴义を次に求します。 

7 7■イルスペック|+フ T イルスペック [+ フ7イルスべ7ク…111 

すなわち、いくつかのフ7•イルスペックを r+j 4 C 号によって K 切って指定で>ます。 
また、その除に、+の m 後にスぺ-スが人ってもかまいません。コマンド中でのこの檐 
能は，すべての通合する77•イルか Hi —のファイルスペックによつて指定されたのと 
まったく PJ じです。 

搜合77■イルスペックが存在する7ァイルを指定するために teffl された場合 •• /H X 
イッチ（上 K r 7 r イルスペック J 参. W > をそれぞれのフ7■イルスぺプクの後に衔定す 
ることができます，この場合、 / H スイッチは报 S ： した7ァイルスペックにのみ脚きま 
す。禊合ファイルスペックの拥に/ HX イゾチが拒定された場合は、すべてのファイル 
スベックに対して指定したことになリます。 



CON デパイスを人力 7T イル名として使用すると、行は 3 マンド行と同一の方法で人 
力、 Wife がでさます（2¢「コマンド行の堪生_|を#照>。 J4® を終 J ■するには、 (CTRL] 
+@ rZ) を行の先播で人力します，例えば、 MYF1LE という小さなテキスト 7 t 
イルを作成したい場件には、コマンド COPY CON MYF〖LE で作*できます。 


A>C0PY COH MYFILE 


hffi の例のように、コンソールからテキストの行が入力で S、 人力されたテキストは 
MYFILE というファイルに？ f き出3れます。コマン ドはの | CTRI>l +r^ を持つ 
行が入力されたときに終/します， 

-\UL デバイスに我さ込んだ場合は， SS 込まれた文字は単に*视されます • また NUL 
から忒み出すと、エンドォプファイルが武ちに返されます(上紀の例で f^TOLU f^] 
を入力したの?;同じ}。 

大部分のコマンドでは、デバイスを指定するのは盘味がありません（例えば、 CON デ 
パイスは DEL コマンドで削除で S ません) • デパイスが使用されるような3マンドは 
CONC:AT COPY、TYPE のようなファイルとデータのやり取りを行うものです。 




5.1 この®の法 


■数 ft 

これ U 数値が必要であることを示します。コマンドによって IJ—255 まで、あるいは0 
-65535まてのをとります。 

■ セ パレー タ 

この； d 法を铯ってのパラメータが idit されている* ftft 、 それらはセ' V ，ータ ic よっ 
て!？切られなければなりません，セパレータは、〇倘 WI -. の先 ifi の毕.白卩切リ文字 
そして0個] •：» I•.のそれに较く! Tifl によって構成されます。使 ffj できる区叨リ文卞を次 


•令 h タブ： 

r /j 文字で始まるスイッチ文卞はこの例外であり、セパレータが萌にくる必 S はあり 
ません- 

MSX DOS あるいは CP/M-80 のフログラムは7ァイル名のキファイル¢5と拡张チ r COMj 
MR 定しなくてもよい）を人力することによってロード，筻行できます，バッチファイルも拡張 
f •が！ "BATj であることを除いて、同様{:実什することができます • COM および BAT フ r 
イルが同じ名荊で抑一のディレクトリにする場合には、 COM フ T <ルが BAT ファイル 
よリ t 先に兄つけられて•欠むされます-コマンドのディスク上での jT .» な fiR はその*前に 
そのドライブまたはパスを付けることによって指定できます • この坳 ft, 指定されたドライブ 
の描 it されたディレクトリが検索され、 J4 つからなかった場合 'U r U nrecognizedco imn<md j 
(携 t メッセージの場介は， 1 ■コマンドが違います」）エラーとなります。 

ファイル名と桩银了_ <指定しなくてもよい）だけがリえられると、まずカレントドライプの 
* レン！•ディレクトリが拽されます，そ C で ft つかない場 PATH のディレクトリリス 
卜で衍定されたデ< レクト 1 )を*#に検索します。このリスト （i PATH コマンドによって衍 
定、あるいは変史することができます • それでもなお R つからない W 合には、 rUnrecogni^xl 
coimiimidj エラーとな0ます， 

CP/M では、ディレクトりやパス名が存？ t しないため、 CP/M のブログラムはこれらを指 
定することができず、それぞれのドライプの*レントディレクトりしかアクセスできません， 
これらのブログラムを他いやすくするために斑境変致 APPEND が使«できます，これによ 
り、冷レントデ < レクト 1 J と M じように期のディレクトりを検索することがで S •ます。 

ほとんどのコマント•やプログラムは、 r « 準入力 j と r S 中出乃 j を使 W して、入力あるい 
fi 出力をねいます。校準 A 力は通常キーボードに MO 当てられ、標革出力は通}?:闽而に剌リ 
4てられていますが，コマンド行にりダイレクシ》ン記号 Co, r>j および r»j> を 
,*} き、その後にテ•パイスまたはファイル名を描定することでその3マンドを•美行している間 
別のものに®えることができます。ひとつのコマンドの«準出力はまた、2つの:>マンドを 
r |j sC 玲でつなぐことによって、次のコマンドの揉爷人力に送ることができます • これらの 
拽能にっいての； f 細は.1!¢「リダイレクションとパイブ j を参照して下さい。 

外 SB 3マンドが欠行されると、その3マンドは COMMAND2.COM が®川していたメモ 
リの-•部をオーバーライトすることがあります。したがってコマンドが終了すると、 COM- 



第5¢コマンド 


MAND2.COM は&衫 J にロードされた COMMAND2.COM ファイルからメモリへ自分 fl 身 
を再 D —卜する必要があることがあります。このフ7•イルは SHELL の®境変数で指定され 
る 7T イルか検索され、そこになかった場合にはブートドライプのル_トディレクトリの 
COMMAND2.COM が検索されます。それでもつからないと，メッセージが出力されま 
す。阑えば， MSX-DOS がドライプ A からブ-卜 sn ■たとすると，メッセ--ジは次のよう 



ルートディレクトリに COMMAND2.COM があるデイスクをドライプ A に挿入してキーを 
押すと， COMMAND2.COM が再 D- ドされ，システムの JA 作が止常に絞行します。 






si この 9 ■.の*記 il 



M 2.1 この令の SiC 法 



5.2 コマンドー覧 


以下に示すのは、 MSX-DOS で利 ffl で3る樣奉の令コマンドのリス!'です，その構文と0 
妁も 4C します。 

• ASSIGN |d： [d:|] 

論坶ドライプと物琿ドライブとの夕れ t: を a 定します。 

• ATDIR +tj| H [/H][/P] 裡合ファイルスペック 

ディレクトリの械性を* K して、それらを可®•不 -f 祝にします • 

.ATTRIB 坪!? | + M】|/P] 孩合フ T イルスベック 
ファイルのを変 SL て、それらを祝•不可视に、そ L て边出し W.W •浚み S_ き可 
能に a 定します。 

• BASIC |ブ〇グラムI 

制脚を MSX-Dihk BASIC に波します • 

.BUFFERS ；»»] 

システムのディスクバッフ t の数を表示 • します， 

• CD [d:] 【パス1 

々レントディレクトりを表示•変史します， 

• CHDIR : d:】 [パス1 

冷レントデイレクトりを表/了い変更します • 

• CHKDSK [d:][/F] 

ディスクI..のファノルの费合性を梭査します- 

• CLS 

_曲をクリアします。 

• COMMAND2 [コマンド] 

コマンドインターブリタを起 W します。 

• (: ：ONCAT [/Hl[/P)[/B)[/V|[/A] 裡合■フ T イルスペックフ r イルスペック 
ファイルを連結します • 

• COPY [/A)[/H]|/T][/V][/P][/B] 3ビー元フ r イル [:» ビー先フ7■イルI 

7 T イルまたはデパイスから他の77•イルまた <i デパイスへデータをコビーします。 

• DATE |fU+J 

現在の h 付を«ボ • a 定します。 



5.2 コマン h—H 


• DEL [/H][/H] ftft •ファイルスペック 
ひとつあるいは » 数のファイルを M 除します。 

• DIR |/H](/\V]|/P] |投分フ7•イルスペック| 
ディスク t ■.のファイルの名®!を表示します， 


DISKCOPY !d: |d：|]l/X)C/5j 

ひとつのディスクを別のディスクにコビーします。 

ECHO [テキスト| 

パ y チ77■イル中でテキストを$示します • 


ERA |/HK/P] 褀 ft •フ r イルスペック 
ひとつあるいのファイルを削除します • 
ERASt 1/HK/P] «介7ァイルスペック 
ひとつあるいは拽*の7 7•イルを削除します， 


EXIT ；»«] 

COMMAND2.COM を*？•了し、 》f び出したブ d グラムに)!3リます。 
FIXDISK |d：][/S] 

テイスクを MSX-DOS2 フォーマットにします， 


FORMAT [d:] 

ディスクをフ t -マット（初期化）します， 


HELPED] 

VISX-DOS 槺能についてのオンラインヘルプを投供します。 


• IF {NOT； 菜件： J マンド 

籴件判断をしてコマンドを実行します。 

Cfe^loFF] 

• KXJODE [ftffi|-OFF |/S] 

薄す•モードを设定•解除します。 


MD [d:] パス 

»f しいサブデイレクトリを作成します， 
MKDIR [d:] パス 

新しいサブディレクトリを作成します。 


MODE 数坫 

rtiffl の桁 • 行数を変更します。 

MOVE [/H][/Pj «合7アイルスペック|パス| 

ディスク h で、ファイルを別のディレクトリに移勒します。 




RMDIR [/H)[/P] ■フ 7 ■イルスペック 

ひとつあるいは W 数のサブデイレクトりを削除します， 
RNDIR [/H]|/P] ■フ7■イルスペックファイル名 

ひとつあるいは後*!(のサブディレクトリの名前を！ S1E します。 
SET| 名 tfiK セパレ-夕II於！ 

琪增® f ■(を s ボ • as； します。 

TIME [時問| 

现 A の時! w を表ボ • a 定します。 

TYPE |/H]1/P1J/A][/B] «合77•イルスべ.,ク丨デパイス 
ファイルあるいはデパイスからデータを表示します。 



5.2 コマンドー！ S 


VOL |d:】 [ボリューム名 i 

ディスクのボリューム名を表示*変®します， 

XCOPY |77■イルスペック |ファイルスペック j] |/A](/E|[/H)[/M|(/P|1/S)|/T][/V|[/WJ 
ひとつのディスクから別のディスクへファイルおよびディレクトリをコビーします。 

XDIH p7 7•イルスぺツク] 1/Hj 

ディレクトリ中のすべての7ァイルのリストを衣承します。 


ASSIGN 

内部コマンド 



ATDIR 


内部コマント 




53 コマンI••の; ft 叫 


ATTRIB 

内 fl：37 ンド_ 


フ r イルの WH を* K し、それらを -I ■祝•不可祝に、あるいは决み出し# 
«!♦ ,•! •き込み可 fig にします。 


ATTRIB +H | -II | +R | R [/H](/P| S 合フ7•イルスペック 

祺办フ7■イルスペックで描定したフ7•イルのを史 E します。 
ATT1UB コマンドでは以ドのスイッチが使えます。 


/H イ、4祝を味し、不芎找 IsUl のファイルも逛塊の対 ft にします。 
/P ぺ•ジモ->1••を .ffi 味し、デ<スプレイいっぱいに衣ボされたところ 
で表示を中断します。衣示を _H 明するには住;£のキーを押します。 


ファイルスペック」では、 K 件を®史するファイルを指定しま 
す。 /H スイ/チが柄定されると、不河祝のファイルもまたその Wtt が* 
K されます。 

+H を栢•走すると、迸択されたファイルの®件 li イ、ギ祝に変 «S れて、 /H 
スイッチが指定されないかぎりほとんどのコマンドによって彩想を受けた 
•), I)1R コマンドによって衣;六された*)しなくなります。 

Hliifi 択されたファイルを4祝状‘想!：します。 -H オブシ3ンは 、ス 
イッチが併定5れていない場合には何の効果6持ちません。 

+R が指定されると、衍定されたフ7•イルは泌み出し#用となります 
は指定され*••フ7■イルを泌み出し • 方き込み坶雄のファイルと L ます.淡 
み W し#用フ t イルは，宵き込みや変 1E ができません， 

エラーが起きると、ファイル fi に较いてエラー/ッセージが表示され 
コマンド liKrr します。 

DIR コマンドを使用して、ファイルの W •注を衣/!;•することができます。 



FILE1 という77•イルを淡み出し専川にし、これ以後、变 E や削讼ができ 
ないようにします- 




第 5 な：!マンド 


B:D1R1 というディレクトリ中のすべての*. COM フアイルを不可視状態 
にし、 Dill コマンドによって衣/了、されないようにします。 



DIR1 中のすべての77•イルを较み出し • »き込み可能として、さらに可 
说状雄にします。内面出力がある場合には1阀面ごとに停止します。 


ぃン ATTRIB +R 


fDIRl + 和 IR2 ♦ FILE1 


DIR1 および DIR2 といつディレクトリ中のすべてのフ7•イル、および 
FILE1 というフ T イルを K み出し毋用とします。 



コマント•の成1»1 


BASIC 

内邡コマンド__ 

I 能 I MSX Disk BASIC に制御を移します。 

[•サ式 " j BASIC [プ〇グラム«| 

[W ；){ ] |ブログラム名】は、ディスク上の BASIC のブログラムの名前です。 

制御は内*の MSX-BASIC に®され^ブ〇グラム名が指定された坳介 
には，その BASIC ブログラムが〇— ド後、尖行されます。 RAM ディスク 
が议定されている場合には， BASIC でも引较き使用できます。 

BASIC の3マンド CALL SYSTEM (“3マンド名”を ft 用して MSX 
DOS Iこ扱ることができますが、この場 ft、MSX DOS で実 h ■可能な任念 
のコマンドをして、それを実打させることができます-コマンドが衍 
：£されないと、11£80〇13八1'というバッチ7 7 > イルを検索し.あれば 
REBOOT.BAT を尖行します（バ y チ 7r イルについては、7¢を参照)。 

| rz^c ) 


MSX-Disk BASIC のモードにします。 



MSX-Disk BASIC のモードとし、 MYPROG.BAS という BASIC のブ〇 
グラムを d _ ド後、其行します， 



BUFFERS 

内部コマンド__ _ _ 

[機能丨 システムが使用するディスクバッファの攻を衣示‘変®します， 


[S •式 | BUFFERS [Scfii] 

[W 说 | 数値か衍；£されないと，システムが％ fr.tti 用しているディスクバッファ 

の数が.及/： R されます，我値が ffl 定されると、バッファの»が街; i の ft に变 
电され、衍定した tt» が U 明のものよりも小さい增合には，不*となった 
メモリが他の H 的のために解枚されます.指定されたパッファ»を確保す 
るだけの十分なメモリがない場合には.取れる限のハ•ッフ t か取ら iu 
エラーにはなりません， 

ディスクパッフ7•の数を增加させると、ある«のアブリケーン3ン、持 
にフ7■イルへのランダムアクセスを実行■するようなものでは、戈行速度が 
向卜.する=1能性があリます。ただし、 R を10以 .h にしても•夫: ii 速攻 
はそれほど改#できず、メモリの浪〇となってしまいます。 


ディスクバッファとして使用されるメモリ铕域は環境変数やファイルの 
オープンにも利科さされます， したがって、 パヴファを" r 能な限り多く设定 
したままでは、ある W のコマノド、柃に SET, COPY および CONCAT な 
どのコマンドが其けできなくなることがあります。これらのコマンドのど 
れかが r uotpnongli memory j r メモリ*-が; S •りません _i エラ—を WJj し 
た* ftf! •に U、 パ/ファの»を減らすことで対応できる場合があります。た 
だし、パッフ7•の ft を3よ9小さくすると、支行速皮は轤しく低下します。 

システムのデフオルトの八ッファ数は5で、•大®分の川速にはこれでI 
分です。 


1_ 文例 j 


デイスクパ7 7 7■の M 在の数を表ボします（この例では 5h 








3.3 コマンドの iiWI 


CHDIR 

内如3マント_ 


カレントデイレクトリを突圯します。 


[ /? it ) CIUHR [d:| [パス1 
または 

CD |d:| [パス1 

[W iil | パスが梢 S されない場合には、カレントドライプ、あるいは ffii ドライ 

プのカレントディレクトリパスが农示されます。これは、ルートディレク 
h リか b カレントディレクト IJ へのディレクトりぺスです。 

パスが很定された項公には、カレントトライプ，あるいは指定ドライブ 
のカレントディレクトリが、パスによって指定されたディレクトリに変 e 
されます。 

どのドライブの*レ〆トディレクトりを持っています。カレント 
ディレクトりはそのドライプについて、 W 後 CCHDIR 3マンドによって 
指定されたディレクトリ （W 初にいるデイレクトリはルートディレクトリ> 
になっています。そして、新たに CHDIR コマンドを枏定するか、あるい 
はディレクト U がアクセスされたと S にそのディレクトリが兑つからない 
場合（例えばディスクが交換されたような場 ft) まで有効となります，後 
者の場合には、カレントディレクトり li ルートディレクトリとなります. 

CD コマンドは CHDW コマンドの短 tf (形で，简便さのためと MS D 參 S 
との勾推性のために抜供されています。 

3マンドプロンプト （i、SET PROMPT ON コマンドを任用して々レン 
トディレクト U を衣ホするよう c«+lii で S ます（8穿の««*»にっいて 
の id 述を#照 K> 

x m 

カレントドライプのカレンI•デイレクトリを DIR1 に*®します。 

(»>CHDIR i:DIB2 

ドライプ A のカレントディレクトリを，そのサブデイレクトリの》»12に 
変史します。 






5 3 コマンドの说叫 


CHKDSK 

外® コマン ト _ __ 

'梭能」 フ7イルシステムの整介件を検 i*t します。 


[A 式 j CHKDSK [d:)[/F] 

[W Ji I 衍定の，あるいはカレントト•ライプのフ t イルシステムのデータ ffi 造の 

格 fHI: をベ，又われたディスクスペースをチェックします。デ■(スタに 
エラーが発 as れると，修&が行われます。クラスタが失われていると、 
失われたディスクスペースを tt 用 “r 能なディスク x ペースに変換するか. 
あるいはフ7■イルに®換するかについて、入力を系长します。後名が•遵択 
されると FILEOOOO.CHK, FILE0001.CHK などの形式の7 7•イ ルがルー 
トディレクトリに作成されます， 

CHKDSK コマンドでは以下のスイツチが使えます。 


/F 戈除にディスクの««を行います。 

/F スイッチが供定されていないと、 CHKDSK は尖!! S にはディスクの修 
很を行いませんが、修拟を行ったときと M じメッセージを衣ボします。こ 
のメッセージによって、 /F が指定されたと S にデ< Xクにどのような Kb 理 
が行われるのかをあらかじめ確;8できます。 

ある捕のブログラムが中析されたときに、ディスクスぺ_スが失われる 
(• ■大われたクラスタ_!が免生する）ことがあります。これは特に CP/MO 
ブログラムについてあてはまります， 

CHKDSK はすべてのデ<Xクについて定#的に戈行するとよ h でしよう。 

メディアタイプが MSX-DOS2 7 ォーマットでない場合、その»を表ポ 
する播能が ve-CfflB i;iP* •■した • 


A>CHKDSX B: 




620K in 89 user files 




82 


A>CHKDSK /F 

20 W の失われたクラスタが lW のチ i ィン巾に) i つかりました. 
欠-われたチェインをファイルに変«しますか (Y/N)? 


カレントドライプのディスクが検奔され、破»クラスタが検出されまし 
た* / f が捎定されているため、ディスクが修很 s れ、破} irn 所が回扱し 
ます。 




53 コマンドの說叫 


CLS 

内部コマント 
「"1 

[ » SH ] 
厂文例； 


画面をクリアします- 
CLS 

画面をクリアして、カーソルをホー厶ポジシ3ンに移*)！します。 



豳面がクリアされます。 



COMMAND2 

外 B! コマンド_ 

[梭能]コマンドインタ--プ 1 J 夕を起抑します。 


[ _*} 式 j COMMAND2 1コマンド] 

| W 说| •■コマン Ki は) iflS ブロンブトで入力できる仔意のコマンド（例えば本 

A に釔級されているコマンド> です， 

COMMAND2 はディスクI•のコマンドインターブリタの？；であ 1 )、外 
部コマンドとして文什することがで S ます。これは®常システムの起站 
時に MSXDOS2.SYS によってロード、•失:されます。それによって本, 》f 
中のすべてのコマンドを其行することができるようになります。 

しかし、•によっては授々の<1山でもう1改コマンドインターブリタを“ 
抑したい堪合があリます。例えば、 2SH に起抑された COMMAND2COM 
11より斩しいパージ a ンで、より多くの楱能を提供しているような場合が 
考えられます。ある»の褀鞣なブログラムのよフに、外部ブログラムが他 
のブログラムを口ード，戈??•できる場IV、 COMXlAND2.COM を口ードし 
て仃 ffi の MSX 005 3マンドを}»定することがで$ます。 EXIT コマンド 
で COMMAND2.COX1 を終)•すると、 MOT(i«ftA；H したプログラム1成 
リます。 

パラメータとしてコマンドが捎定されないと、 C0MMAND2 COM は 1 H 
に; JlifR のブロンブトを出力し （AUTOEXEC.BAT あるいは REBOOT.BAT 
を其行せずに>、通常のコマンド待ちの状路となります。 EXIT コ7ンド 
が人力されると，起 W された COMMAND2.COM は終 ) ■し元の COM 
MAND2.COM またはブログラムに识リます （P.103「EXlTj を蓚!«>, 
この EXIT コマンドにエラー：3— ドがり•えられると、尤の3マンドイン 

夕ーブリタまた《ブログラムがそれを受け取リ、 COMMAND2.COM と 
MSXDOS2SYS の場合には、；1切なエラーメッセージが出力されます <9 

¢1 1 •エラーおよぴメ k セー yj を#照）。 

•方、 COMMAND2.COM へのパラメータとしてコマンドが指定され 
ると、そのコマンドが通常の方法で入力されたのと M 様に其行されます。 
コマンドは内部コマンドでも、外部コマンドの COM あるいは BAT 7r 

イルでもかまいません。コマンドを尖忖し終ると、 COMMAND2.COM は 
そのまま元のコマンドインタープリタ、あるいはプログラムに制御を K し 
ます。 


このような力で、通常のコマンドイ〆夕ーブリタから2 SU の COAl 
MAND2.COM を、パ y チフ T イル名をコマンに指定して起勒すると 



COMMAND2.COM が实行されると.すべての®塊変数がセーブされ， 
終！■するときは元に反されます，このようにして，新たに起®)された COM- 
MAND2.COM は玷初の变数を別き継ぎます。ただし、琛堍《数が未 
定義である場合には、デフォルトの S! 境変数を»定します。新たに起勧さ 
れた COMMAND2.COM が実行されている間に行われた®堍変数の変® 
は、その COMMAND2.COM が実行されている明だけ有効であり、終了 
すると失われます。 

C«MMAND2.C0M が起物されるごとにメモリが消»されますが、終/" 
するとそのメモリ11再び解放されます。これは、環境変*！:の数に依存しま 
すが. M 常は 1.5K パイト程度です， 

COMMAND2.COM が外部ブ a グラムを兴行すると、ブ〇グラムは COM- 
MAND2.COM が占有していたメモリの一部を使用することがあります。 
その場合， COMMAND2.C«M はプ〇グラム終了後に S 分 H 身をディスク 
から洱〇-ドしなければなりません。その時、 C0MMAND2.C 參 MU ファ 
イルの媒所を検索するために、現境変数 SHELL を利用します<15堍変数 
については8幸を#照），ディスク上の COMMAND2.COM が最初に〇— 
卜•されたとき SHEIX はそのファイルを参照するように S 定されます。 


A>C0HKAND2 


析たに COMMAND2.COM が〇— ドされ、通常のブ〇ンブトを出力しま 
す， EXIT によって元の COMMAND2.C 鲁 M に戻ります。 


A>C0HMAHD2 FILE.BAT 


通常、パッチ77•イル中で指定します。 FILE.BAT というフ t イルが実行 
され、それが終了するとこのコマンドの次のコマンドから現在のパッチフ T 



CONCAT 



[梭能丨 フ7■イルを連結します（つないでひとつにします >• 


L » 式. C 參 KCAT|/H1[/P|I/B| レ V][/Al 汝办フ7•イルスペックフ r イルスペック 
[解说丨 後合ファイルスペックでは： St 結するファイルを衍定します。 

2SB のパラメータのファイルスぺックはワイルド々-ドを ft んではな 
らず.そのファイルはソースファイルが说まれる前に成されます。その 
後それぞれのファイルが»まれ、 i9 •荊のフ r イルの終りに违結されて、 fi 
的のファイルに方き出されます。 

それぞ i"i のゾースファイルが瑰まれるごとに、そのフ7■イル汽が m 力さ 
れます。何らかの fflrti でそのファイルが政めない場合（例えば、それが出 
カファイルとして生成されているような場介）には.そのファイル名の後 
にエラーメツセージが较き、 CONCAT の処理は次のゾースフ T イルから 
規けられます， 


CONCAT 3マンドでは以下のスイッチが使えます。 


/H 不可視ファイルを連結可能とします， 

/P 出力を lffliffi ごとに（何らかのキーが押されるまで）停比します。 

多くのフ T イルを it 結させるような坩合に使います， 

/B バイナリフ7■イルとして扱ぃます ■> 

a み込まれるデータはそのまま扱われ、のデータも h け加えられ 
ません。また， /B は出カファイルや複合ファイルスペック中の ft 
意のファイルスペックについて、指定することができます。その場 
合•には. /B 11それらのファイルについてのみ■(•効となリます， 

/A ASC117T イルとして扱います（デフすル!'です）。 

/V CONCAT コマンドの実行中、基き込みチエンクが有効にな 1 )ます 
(P.146 fVERIFYj を参照)。 

これによってべリファイ梭能を持つディスク！••ライパを使川してい 
れば、データがディスクに:0：しく卉き込まれることが保 s£ されます 
が， S き込みチ*クをするふ-ん tt«i 時阳がかかリます • 

通常連結は ASCII ファイルに対して17•われます。それぞれのソース 
フ7■イルは、 to 初にエンドオプファイルを表す文卞 ((CTRLl + [2]) が 
現れるまで说み込まれ、すべてのデータが甚き出された後、沿後にエント 
オブファイル文字を出力して終了します。 



^ A>COHC*T *.OCC ALL.Pf 




第5¢コマンド 


COPY 

w 部 コマンド 

[嫌能1 フ T イルまたはデバイスから、他のファイルまたはデイXへデータをコ 

ピーします。 

[® 式] COPY [/A][/H][/T][/V][/P]|/B] 複合ファイルスペックファイルスペック 

|解説] 褀合ファイルスペックでは、コビー元のフ7•イルを■定します。デパイ 

スの措定が ft まれていてもかまいません。 

フ T イルスペックでは、3ビー九のファイルを指£ます。3ビ ー56 の 
ファイルの定義を次に示します。 

• [AH パス】Iフ T ィル积|デバィス 

ここで4とパスはデフォルトではそれぞれカレントドライブ、々 
レントディレクトリとなリます • 7ァイル名の一®分にワイルド々一 
ドを含む場合にはソースファイル名から迪切な文卞が代入されます， 
7ァイル名が* j. えられないと，ソースファイルの名前がそのまま使用 
されます。コビー光のファイルにディレクトリを 1SS すると、7ァイ 
ル名を*•ホとして、ファイルがそのディレクトリに3ビ—されます， 

COPY はファイルを*?出す M にできる限り多くのソース7ァイルをメ 
モリ中に ai み込み、〆モリがいっぱいになった時点で、忒み込まれた壙に 
フ7•イルを; 1 f き出します，それぞれの出カファイルが生成 s れるたびに， 
y- スフ7■イル名が出乃されます。 （K 力7ァイルが作成不可能な場合には， 
エラ-■メッセージが出力され、3ピー»杜は1欠のファイルに邋みます。 

«み m し存用ファイルが _nj -•の名*ですでに存在している場合など 
COPY が出カファイルを作成で S ない® W は多します。 ユーザーが 
K りを犯しているかもしれないような•には、 COPY は出カファイルを 
作成しません。例えぱ、フ T イルを G 分0#に3ビ_することはできず、ま 
た禊数のファイルをひとつのファイルへコビーすることもできません•ひ 
とつの7ァイルの汛力が以 as のソ_スフ7■イル、あるいはすでに他に使用 
されているフ7•イル（例えば IJift. 戈行中のバソチ7ァイル〉の内容を消して 
しまうような場介には、 「Cannot create destination』 r ファイルを作成て 
きません _i エラーが出力5れます。また、多くの 7T イルをひとつの77■イ 
ルにコビーしようとすると、 r Caimot overwrite previousdestination filej 
「ファイルの 4 ね JfS ができません j エラーとなります。これ lijfi 常、コ 
ビ _3t のファイルにディレクトリを据定しようとして、その名を間違っ 
て播$した場合に起こります。ただし、3ビ_先のファイルがデハイスの 
場 ft •は、エラーにはなりません， 



53 コマントの戎明 


COPY コマンドでは以下のスイッチが使えます。 


/H 不可の7ァイルもコビーします， 

/P 11*1 而ごとに〆 y セージ出力を伶出させます。 

/A ASCII コビーが戈 ti •されます。ソースフ7•イルの最初のエンドオブ 
7ァイル （EOF) 文卞 (|CTRL1 + |Z|) まで■を«み込み、それぞ 
れの出力7ァイルには、フ7•イルの扱後に EOF 文 T. が付け加えら 
れます。また、/あるいは褀合7 7■イルスペック中の ft 
3$の77•イルスペックに«別 UffiS することが" f 能で、その堪办に 
は，指定したソース、あるいは出力にのみ冇効となります。 

/B 八イナリコビーを行います。忒み込まれるフ T イルがそのままコ 
ビーされ，ファイルには何もデータが付け加えられません。 

/V COPY 3マンドの Ja 理の刖、ディスクドライパがベリフ r イ檐能 
を持って Wl ば3き込みチ*ックを ii •います (P.146「VERIFY」 を 
参照〉。これによってデ_夕がディスクにしぐ, 1 f き込まれること 
をしますが、姑押にかかる時 IW は增加します。 

/T 出カフ t イルには税&の11付と呤冊が玟定されます。 


出カフ7■イルはソースフ t イルの Wtt にかかわらず耐视であり、 iff み片 
き4能として作成されます， ATTRIB コマンドで、これ h の W 性を変 K す 
ることができます。 

/T スイ y チが指定されなかった場合、出カフ T イルにはソース 7r イ 
ルと同じ B W と時叨が Ka されます。 

COPY によって r Notcnaugl) memoryj r メモリーイ、足てす j エラーが 
起こるときにはパッ77■致を減少させる (P.76 UUFFERSj を#™) 
か、あるいはいくつかの S 境変数を除上 （8 往软の silij を茶照） 
して I- 分な<7-ク； t リアを»保して下さい。 


x m | 


COPY コマンドは7 7•イルの:*結（ファイルをつなげる）をサポートし 
ていないため MS DOS や MSX D0S1 のものよVも楼能が簡潔になつ 
ています。7ァイルの連結を■うには、 COVCATa マンドを使用してド 
さい (P.86 r CONCATj を参.明)。 



FILE1 というフ7•イル名の7ァイルを、亡レントドライブの々レントデイ 
レクトリからドライプ b のカレントディレクトリへ ra じファイル名てコ 
ビーします。 



笫 5 ¢6 3マント 



/H スイッチで MSXD0&-2SYS および COMMAND2.COM という2つの 
不ファイルをドライプ b にコビーします。ブートディスクを作成する 
ような場合に使用します。 


*>C0P» A ： n>IHl /V 

ドライプ A のルートにあるディレクトリ 1)1111*1* のすベてのフ7■イルをド 
ライブ B の闕名のディレクトリ K コビーします。その際に、ファイルが K 
しく SS 込まれているか •» き込みチ*ックを行います- 



ドライプ B のカレントディレクトリ中のすべての 7r イルを#レントドラ 
イブのカレントディレクトリに3ビーします。 


A>C0PY A:«.D0C B:/T 


*.DOC に遑合するすべてのファイル（例えば F1LE1.DOC、F1LE2.DOC. 
FILE3.DOC など）をドライブ B のカレントディレクトリにコビーし、 
*.DOC フ7■イルの H W •および《4問の代わりに、«在の H •と時明を:！ビー 
された7 7■イルに设定します， 


AUTtlEXE 


REB00T.BAT ― File cannot ba copied onto ltsalf 


この例では、本. BAT に iA 合するすべてのファイル（ここでは AUTOEXEC.BAT 
と REBOOT.BAT) をカレントI••ライプの々レントデ■(レク••リ内でコビー 




5 3 コマンドの说明 


するように COPY を使用しているが、 COPY はメッセージを出力してこ 
れを鹜告しています。この埸合には、フ T イルは X® にはコビーされてい 
ません， 



この例て•は、 *.BAT に迪合するすべてのファイル（ここて -(iAUTOEXECBAT 
と REBOOT.BAT) を DIR2 というディレクトリ(こ：！ビーするために COPY 
を使用しています。しかし、 DIR2 は存在していなかったため DIR2 はファ 
イル名として解 K されました*したがって AUTOEXEC.BAT を DIR2 と 
いう77•イルに：》ビーし、それから REBOOT.BAT も DIR2 というファ 
イルに:！ビーしようとしました。これはたぶん間遠いであろう（この場众 
D1R2 というデ•（レクトリが存在しない）ということで，籽告のメッセー 
ジが表示されました， REBOOTBAT は尖瞄にはどこにもコビーされてい 
ません， 




第 5 电3マンド 


DATE 

内部コマンド 


[檐能]祝亦の口付を衣 a • as します。 


I 涔式丨 DATE (IH-J-] 

Q ai ] このコマンドの後に n 付を析 a するとその ii 付に; a： 定されます（入力形 

式についてはド紀参照）。コマンドの後に Hfl ■が指‘ i されないと％允の H： 
[Iと H 付が出力され，新しい•の人力衿ちとなリます。ここで何も入力 
しないと <つまり、@キーだけを押すと）、の Hfl は変史ませ 
ん》八力があるとその入力 U 新しい日付であると»なされ.後述のように 
解釈されます， n 付が挺*であるとエラ-メッセージが表ポされて冉ぴ坊 
しい n 付の入力侍ちとなります。 

B 付は3 «までの数卞で術成され、それそれは次のような区切り义卞で 
b (.切らなければなりま -14 •ん。 


空 n タプ 


文字のどちらかの俩に空 n があってもかまいません。数字の人力を省略 
したフィ_ルドにはの设定が使用されます。年の人力は ■» 桁でもド2 
桁でもかまいません，後者の場合には、上2桁は年が 80KU-- のと S には 
19. 小さいときには20として解釈されます， 

HfJ •の表/！;•および人力の形式には柔枚件.があり、変 K することがで S ま 
す， DATE という環塽紫«がその MSX マシンが使用される15の形式に迪 
■ft ■するように、デフオルトで设定されています（8¢の63堆«数について 
の SC 述を審明}。 

例えば.II本向けのマ'ノンではデフォルトの说定は YY MM DD です， 
SET DATE DE)-MM YY というコマンドで、II付の形式をヨ••ロツバ 
杉式に変! E することができます • この形式は Dill コマンドによって衣习くさ 
れる HM •にも反映されます。 

S 境® ft DATE が定袭されていると、それは DATE コマントによって 
HfJ •の人力で必要な形式としてホされます。 


j A>DATE 91-9 



[文例 J 


現在の n 付を1991年9月2〇 a に s 左します。 



Current date iE Sat 1991-09-20 


%在の H 付は（十.） 1991-09-21 です 
新し ViHW •を人 Jj して T さい (yy-mn-dd) : —21 


ラメータが入力されなかったので*在のII付1991牛 9/)20 0 が表示さ 
新しい H 付の入力 f$ ちとなります。プロンプトへの応答において21 B 
を指定するだけで、 H 付は VD に电新されました-年と H は指定を省略し 
たため，«圯されません， 


A>SEI DATE - DD/MM/YY 




DEL 

内部コマンド 


柒5¢ 3マンド 


f 檐能 I ひとつあるいはのファイルを削除します • 

[杏成 ]DEL |/H】【/P] 极分 7T イルXベック 
または 

EpA [/HJ/Pj Jg^ft •フ r イルスペック 
または 

erase I/HII/P] ft 今7 r イルスペック 

[W % I tt<V ファイルスペックでは削除する77•イルを析 S： し*す》 

DEL コマンドでは以下のスイッチが使えます。 

/H ;»f 規フ r イルも M 除できます。 

/P 出力を1函豳ごとに f? 止させることができます • 

削除の処坤中、ファイルが何らかの理山で（例えは • 「5*み出し作用 j に 
セヴトされている塢合）削除できないと、そのファイル名**エラーメッセー 
ジとともに出力され、 BIJ 除の％®は次のフ7•イルへ道みます。 

ファイル名が*.*である場 ft 



というプロンプトが衣承され、ユーザーの応答 f$ ちとなリます。 li> 答が 
r vj あるいは 「Y_1 以外である場合には、フ7•イルの削除は行われません， 
これは、ディレクトリ中のすべてのファイルを為って消去してしまわない 
ための K* です • 

MSX-DOS2 でフォーマットされたディスクト.で削除されたフ r イルは， 
削除の 8t 後に UNDEL コマンドを使用すると极活することができます。 




5-1 コマンドの説明 


FILE1-BAK という7アイルをカレ〆トドライプの々レントデイレクト U 
から fflEfc します。 


i>DEL >.COM/E 

木. 《>M に適合する1ベてのファイルを "f 視•不 W ■祝にかかわらず削除し 
ます。 


*>DEL B:WJTlL»-.COMtB:»Um»».BAT 


*.COM または*. BAT に通合するすべてのフ r イルを，ドライブでの UTIL 
というデイレクトリから利除します， 


*>DEL B:wra 
I Erase all files (Y/N>7 


(A>DEL B:¥UT11 

I 全てのフ 7 ■イルを « 去しますか CY/*)» 


ドライプ B の UTIL というディレクトり中のすべてのフ T イルを削除しま 
す。多くのファイルが拥除されるため、ブロンブ!•が Wr 初に*示され iftiH 
去を防ぎます。 



*>DEL ••BAT 

AUTOEXEC.BAT — Raad only llle 
REBOOT.BAT — Raul only lila 


A>DEL t.BAT 

AUTOEXEC.BAT —ファイルが i* み出し典用です 
HEB00T.BAT — 7アイルが校み也し#坩です 


厲 rtA 位み出し専用となっていた AUTOEXEC.BAT および REBOOT.BAT 
を除いて. *.BAT に:»合するすべてのファイルを削除します。 



菹 5 萑3マンド 


DIR 


[_ 拽能丨 ディスク I •.のファイル名を衣/ヌします。 

[* 式] Dm |/ H ][/ wj |/ r 胸合ファイルスペック 1 

「解説| •■後合フ7•イルスペック J は. S 示すべきファイルを ffii します。 

D 1 H コマンドでは U ドのスイッチが使えます。 

/H 不视フ7•イルも表示されます- 

/ W ワイト•形式で表示され、1行に«»のファイル名が出乃されます 

/P 出力は1内西ごとに伴止 L 、 キー人力伴ちとなります。 

Dllt 3 マンドでは他のすべてのコマンドとは異なり、1■.ファイル名やフ T 
イル名拡を併定しなくてもよく、どちらも«略時に U r * j と解釈され 
ます，したがって、フ7■イル45 r FREDj It r FHF.D.*j と PI 等で、ファイ 
ル名 r . COMj は r *. COMj と fB ] 等です。主ファイル名の fi 後に 1 ". J が批$ 
されると、扯®子も播定されているものと兄なさ* U フ7■イル名 r FRED.j 
は1:足の例とは興な I )「 FRED . tj とは|用其とは見なされません。 

表/: R には2つの形式があります • / W スイッチを捎定すると、リストは 
ヮイ ド形式で衣示1行に拽数のファイル名があわされます。サブディ 
レクトり名、フ7•イルの«件、それぞれのファイルが fr : rfc された tl 付と時 
問は、表/: ns れません， 

/W スイプチを指定しないと、それぞれのファイル？5はその»性，ファ 
イルサイズ，供後に作成された日付と時 M とともに1行に1ファイル;6 
示されます。厲性はファイルが TA み出し専用の場合に 1 "り、イ、” r 视ファイ 
ルである場合 （/H が推定されている場会）に n«j として表ボされます。 
フ7■イルの時問がゼロ（ファイルがそれに ra 連した時 low 報を持たない〉 
の场合，時 B3 は*ボ5れません。ファイルの B 付がゼロだと、 Bl.ft 時間も 
表示されません0 n 付と時冊の表ボ形式は变 k することがでさます (P92 
r DATEj およぴ P.139 TLMEj を备照)。 

/ w を指定 l ない»示は4〇文 t : ea に収まるようにデザイン s れてい 
ますが、それよりもデイスブレイの桁 S が少ない場合には、衣ホを1行に 
収めるためにリストの一部の項 H が衣示されません • / W が衍定されたと 
きに表ホされる1行ごとのフ7■イル a も由面のにしたがって w 整されま 
す.しかし、表ホ lii が13文字よリも小さい場合には、どちらの％ ft •もフ T 
イル？;は次の行にまたがって表示されます- 



ファイルのリストの一番始めにはディスクのボリューム名と表>1、される 
ディレクトリ名が出乃されます 。 -S 終 1 )には表示されたフ r イルの数. 
ファイルの合計パイト数、来 a 用のディスク領«の1«卜（パイ I •数占示 ( i , 
IKU . ヒの場合にはキ n パイト単位で在示され、垴«は切り拾てゎれます） 
が表ホされます。 

サブディレクトリのディレクトリが&示されるとき、リストされる Wi 初 
の2つの項 H は常に 1 '. J , r .. J と! 1 f ばれる特殊なディレクト IJ です • これ 
らは*)？しいディレクトリが作® S れるときに|4_に作成され，これによ 
り、パス名中で 1 ■■•!、 r .. j によって、それぞれカレントディレクトリ、規 
ディレクトリを指定できます（パスの紀述につ“ては， 5.1 の•■この車の表 
K 法 j を参照)。 


ff.gj 


Voluae id drive i :1> HSX-OOS 2 


HSXD062 SYS r 
C0MKAHD2 COM r 




14K in 2 files 222K 




90-09-03 4:68p 
90-09-11 4:24p 
90-09-20 6:40p 
90-09-20 6:40p 


ドライプ森：のボリューム®は HSX-OOS 2 
ディレクトリ A:¥ 

HSX00S2 SYS r 4480 90-09-03 4 

C0MMAN02 COM r 16472 90-09-114 

UTILS <dir> 80-09-20 6 

HELP «Ur> 90-09-20 6 

14K パイトを2«のフ7"ィルで«!1«巾 
222K パイ I •が使用 "J ■能です 


々レントドライブの#レントデイレクトリ中のずベての77■イル名および 
ディレクトリ名を*します， 

この例からわかるように，このデイスクは MSXDOS2.SYS と COMMAND2 


COM >いう«み m し#用の MSX DOS システムファイルと、 UTILS k 
HELP というディレクトリを含んでいます。 





R B:VHELP/U 

« u> driv« B:is KSX-DOS 2 
Directory of B:*HELP 




SYNTAX .HLP E 
EDITING .HLP 
26 K ib 10 files 2 


ASSICN HLP 


.HLP BATCH .HLP 


A>DIR B:¥HELP/U 

ドライブ B: のポリュ-'ム名 liMSX-DOS 2 
デイレクトリ B:¥HELP 
BUFFERS .HLP AITRIB .HLP ASSIGN 

ATDIR .HLP CHDIR HIP CD 

SYNTAX .HLP ENV .HIP BATCH 

EDITING HLP 

2SK パイトを 10 W のファイルで使 W 屮 
222K パイトが吋雄です 


ドライブ B のディレクトリ »：LP を7イト'釤式て-表示します. 



UTILS および HELP というデイレクトリ中のすべてのフ r イルを S 示し 
1画面ごとに S 示を停止しま 



5.3 コマンドの lit 明 


DISKCOPY 

外部コマンド_ 

I榷能丨 ディスクを別のディスクにコビーします。 

[* K ] DISKCOPY [d: |d;]] l/Xll/S) 

("解说丨 Wt 初のドライブは複写元のドライプ、 2*E3 のドライブは換写光のドラ 

イプ（デフォルトは々レントドライブ） です。. ドライブを柑定しないと、 
DISKCOPY は複写元、 tt 写先のドライブについて、ブロンブトを出します， 
DISKCOPY を使用する的に、複¥.先のディスクは扭写元のディスタと 
W じフォーマットにしておかなければなリません， IM— のフォーマ/卜で 
ない場 ft にはエラーとなります。 

DISKCOPY 3マンドで (i、 以下のスイッチが使えます， 


/X ディスクコビ _*! 理の問に出力されるいろいろなメッセージが我示 
されません， 

/S ブートコードもコビーします （ver.230 から®加されたスイ/チ 
です)。 

COPY *.* と DISKCOPY の相3点は、荊*がフ T イルごとにコビー 
を行うのに対し、後-#はディスタの内容を方かれている通りにそのままコ 
ビーするところにあります。 

I 







*>DISKCOPY 
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ECHO 

jHfK コ 7 ンド _ _ 

['檐能丨 指定したテキストを衣示します， 

[ # 式] ECHO [テキスト1 

[W Si ] テキストをそのまま两 ifii に衣ポします•テキストを指定しないと空行が 

m 力されます • 

このコマンド(1、 ECHO という0%変数(8¢ r® 境変数の設定」を: e 
照）によって制御されるパッチ7アイル中の r echoj の妆態とは別ですの 
で浞同しないようにしてドさぃ《 


| 1>ECH0 AUTOEXEC batch fil« «x«cut«<l 
AUTOEXEC batch file executed 


柑定のテキスト （「AUTOEXEC batch fileexecutalj) が幽两に出力され 
ます。 




パラメータがリえられていないので，申行のみが m 力されます。 



102 第 5 ft コマンド 

ERA 

内® コマンド_ _ _ _ 

[檐能^ DEL コマン（••と昀じです • DEL コマンド <P.94> を幸照して下さい • 

ERASE 

内部コマンド 

[機能| 1»丄コマント-と關じです。 DEL コマンド （P.94) を#照して下さい。 




5.3 コマンドの說明 
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EXIT 

内郎3マン K 


[機能丨 COMMAND2.COM を終了して，呼び出したプログラムに戾ります。 

[K ! EXIT |数依| 

「解.说1 数他はエラーコードでデ7ォルトは0です • 0は MSX I)OS2 ではエ 

ラーなしを求します（エラ-•にっいては9章を参照)， 

EXIT はコマンドインタープリタ (COMMAND2.COM) を終了して 
コマンドインターブリタを D- ド、実行 (P.84 r C0MMAND2j を#照 
) したプログラム （COMMAND2.CO.Vl、 他のブログラムあるいは坶常 
MSXDOS2.SYS) へエ9 -■コードを挺します， MSXDOS2.SYS の場合に 
は遽内なエラーメッセ-•ジが*示され、 COMMAND2.COM が再口ード 
太行されます。 

COMMAND2.COM は D — ドに現 t の®埦(8¢ r S 塊変数の； S： 定 j 
を参照）をセーブし、 EXIT はセーブされた®境を元に戻します c したがっ 
て、 EXIT によって MSXDOS2SYS に戻る（卜：/プレベルで EXIT を劣 
行する）と S3 境はクリアされ、 COMMAND2COVI の冉口ード後、デフォ 
ル!•の現境が再 a 定されます • これによって、现堆をそのデフォルトの依 
にリセットすることができます 0 




例」 



コマンドインターブリタを終了します • これに技く JW 乍は何がそれをロー 
卜 "L ていたかによって»な0ます。 


I t>EZIT 40 




コマンドインターブリタを.： t ラーコード40で終了します。これは-〆ステ 
ムに登»されているエラーではないため、エラーメッセージは*初にコマ 
ンドインターブリタをロードした <> のによって在示されます。エラーにつ 
いて Ii9fe を事照してドさい。 



FIXDISK 


外*コマン！ 



5.3 コマント•の説明 




いる一部の r ームなどのアブリヶーシ3ンディスクに対して、 /s スイッチ 
を$えるとそのディスクは MSX-DOS1 や MSX-DOS2 を4ち上げること 
はできますがアプリケー•シヨンを立ち h げることができなくなります0 


「文例 


他の'〆ステムのブートディスクを的逢って更新してしまうことのないよ 
うに、ディスクの疋祈の®にブロンブトが出力されます。 


*>nXDISK B: /S 

Disk in drive B: will only be able tc boot HSX-DOS 


A>FIXDISK B: /S 

ドライブ B: のデイ X ク (iMSX-DOS L か >7: ち上げ*こ！:が出*な 
<なります 

何かキーを押してド5い 


ドライプ B のディスタが MSX DOS2 の完全互桷のものに ffi 新されます。 
ディスクが他のシステムのプートディスクかも知れないので，ディスクが 
実 R5 に E 新される前にプロンプトが出力されます。 




FORMAT 

内拥3マンド 










(ver.2.20 のメッセ—ジ） 


C 

*>TORMAT 

Drive sans? (A,B) A 
1-Single sided 
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SS 5 夺コマノト • 


v « t .2_30 以降では、フすーマットするドライプを指定されなかったときは. 
フォーマットできるドライプを衣，7；するので、その中から選んでドさい • 
それ以外のメッセージ Ii ver.2.20 と同じです • 



5.3 コマンドの 
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HELP 

内 ffin マント__ _ _ 

[tt 能 I MSX DOS の檐能についてオンラインヘルプを提供します • 

[ 式1 HELP 

| 解说丨 パラメータを ffi 定しなぃとヘルプで利用で S る4 MAH のリストが衣 >J< 

— されます。これには©進のコマンド>上なンステムの檐能が含まれます。 

Jftll が析定されると、 こ mmi についての梭能解说が r ヘルブフアイル」 
から豳而に出力3れます， 

ヘルプ77■イルは、 r .H し Pj という扯«+がついたフ T イル名て-す■デ 
フすル！•では MSX DOS の！!! <fc のプートディスクの HELP !:いうディレ 
クトリ中にあります。 

HELP とぃう SJ 境*数は 《W、HELP ディレクト IJ を参照するように; S： 
定5れています （S3 堉変坟にっいて118¢を参照)。これは必 S に応じて任 
总の他のディレクト y やディスクを S 照するように、 SET コマンドを使 W 
して変 K することができます。 

また，ユーザーは HELP ディレクトリ中に適当な. HLP 7 7•イルを追加 
するだけで、任, ffi の HELP 項 B を付け加えることがて*きます。ヘルブフ t 
イルは TYPE コマンドで /P スイッチを指定して丧不したのと、ほは R 棣 
に在示されます， 

N•2.30 15境変 ftKHELP を迫加しました。 HELP コマン！••龙 

こ、幽而モー! •• に15匕て ANK そードならば HELP で指定されるディ 
レクトりを' 5* 宇モードなら (f KHELP で街定§れるディレクトリを ft ill 
的に遵択します • それぞれデ7ォルトは MSX-DOS か起 41) されたドライプ 
のルートデイレクトリ巾の HELP、KHELP というデイレクト 1 J になって 
います。 




標本ヘルプ W 而を衣不します。これは®笨のコマンド！： MSX DOS の t 
な梭能を含んだヘルプで利用できる項 H を衣示します-ユーザーが加し 
たものはここでは衣示されません， 




第 5P コマント 


この： j マンドによって HELP はへルブテキストのある場所で ME.HLP と 
いうファイルを検索したが、それが兑つからなかったためエラーメッセー 
ジを出力しました。ヘルプテキストを含む7ァイル Uj 由常 MSX-DOS が 
起勒されたドライブの ¥HELP というディレクトリ中にあり、必要ならば 
任意の他のへルブフアイルを加えることができます。 ME.HLP が迫加3れ 
ていれば HELP ME によって ME.HLP の内容が_面に表示されます。 



5.3 コマント•の•叫 
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IF 

内部；37ンド _ 
I 檐能 I 

Ur ?? I 

[w a ] 


[文例 I 


[MB 


荣件判断をして:3マンドを実行します。 

F [NOT] 采件コマンド 

荣件が A のときにコマンドが突灯されます。 

IF コマンドでは以ドの条件が狭えます， 

• EXIST ファイル名 

ファイル名が存在するときに A になります。 

• 文 T 列1_=文字列2 

文字と文 T 外2が等しいと#に典となります，大文字と小文字 U 
pi じとみなされます- r % パラ〆一夕 j とは変換され 
た後に上匕校されます， 


NOT をつけると条件が成立しないときにコマンドが尖行されます。 
この3マンドは， version 2.31 から追加されました， 



*>IF XPROMPTX=OII ECHO Pr<Mpt is ON 


環境変数 PROMPT が r ONj の* 6 合，上 SE のように r PromptisONj t 
&不します- 
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第 5 章コマンド 


KMODE 

外 a コマンド___ _ 

[機能]澳字モードを a 定、解除します， 


[齐式 | KMODE 数値 | OFF 
または 

KMODE [Kt£ I OFF] /S [d:] 

[M ift I 满字モードの珑定を行います。 ftW は 0-3 で、その息味は Disk BASIC 

の CALL KANJI と同樣です。 Sf しくは11章「 H 本の CALL KANJI 
を参照して T さい。 OFF は ANK モードの指定です。 

KMODE 3マンドでは以 T のスイッチが使えます。 


/S ブートセクタにモードの衍«が#き込まれ、次回からは、そのディ 
スタでは枏定されたモードで MSX DOS2 が立ちI•.がるようにな 
ります•モードを古略したときは現&の薄 T モードが使われ、この 
探、他の z ステムのブートディスクを raa って e 斬してしまうこと 
のないように、ディスタの史析の前にプロンプトが出力されます。 
ドライブ名を宵咯したときは、デフォルトドライプのディスクが対 
象となります。 


浼字ドライパがインストールされていない場合は、以下■のようなメッ 
セージが表ポされますので， BASIC 環境で* "CALL KANJIj を支行して 
下さい。 


• • • use "CALL KANJI" under BASIC 




例 I 



搜屮モード3にします。 



スクリーンモードを ANK に戾します。 



53 コマンドの说明 
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*>KMOOE /S B: 

Disk in drive B: will only be able to boot KSX-DOS 2 


A>KH0De /S B: 

ドライブ B: のディスクは tl 本語 NSX-D0S2 しか立ち上げられな 
<なります. 

何かキーを押して下さい 


メッセ-•ジを出して確認した後、ドライブ B のディスクが〇；ち上がるとき 
に現在の S 字モード（この場合 ANK) になるようにブートセクタを5き 
換えます • 
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MD 

内部コマンド_ 

|描能| MKDIR コマンドと同じです。 MKDIR コマンド （P.115) を多.明して下 

さい。 



5 3 コマンドの说明 


MKDIR 

内部コマンド___ 

機能I 新しぃサブディレクトリを作成します。 

[•今式] MKDIR ド:]パス 
または 

MD【d:] パス 

「解说| パス中の* i 後の要»が、々レントあるぃは播定のドライプで作成すべき 

斬い、サブディレクトリの名锕です 4 これがハブ屮の唯一の®索なら、斬 
しぃディレクトリとしてカレントディレクトリ屮に作成されます。 W しぃ 
ディレクトリを不可％にしたぃ場合は、 ATDIR コマンドを使用してに 
行わなければなりません， 

サブディレクトりのディレクトりが表示されるときの&初の2つの項目 
は、»に 「.j, と" f ばれる特殊なディレクトリです • これらは斯しぃ 

ディレクトリが作成されるときに自 M 的に作成され^これによI)、パス名 
中で 1 ■•_!、 r "j によって、それぞれ勿レントディレクトリ、親ディレクト 
りを指定できま1%パスの記述につぃてはI 5.1r この$の表記法 j を; »S(f 
して T ■さぃ • 

MD コマンドは MKDIR コマンドの短播肜であり、诃便さと MS-DOS 
t の; KflS 性のために提供されています， 



UTIL というデイレクトリを勿レントドライブの*レントデイレクトリに 
作成します。 



RAM というデイレクト _J をドライブ A のルートデイレクトりにある UTIL 
デイレクトリ中に作成します。 



Ilfi 


gsr>® コマンド 


MODE 

内部: 》 マンド _ 

[楢能]両而上の1行の文字数を変更します。 

[® ~式 1 .MODK 数 ffi 

〔解说丨 数械は1〜80までの範囲でなければならず、画 ifi の lft ごとの文卞数は 

その»«に»定されます。このコマン（••を実行すると画面はクリアされ、 
* _ソルはホ—ムボジV3ン（左上 W) に移動します。 


[文 m ] 



«而を8〇桁モードに a 定し、クリアします。 



画面を25桁モードに玟定し、クリアします。 



5.3 コマンドの说明 


117 


MOVE 

内部コマンド 

[^檐能]ファイルを同ーディスク上で別のディレクトリに移します。 

[ 式 ]MOVE[/Hl|/Plftft •フ7■イルスべク1パス] 

[解説丨 1 ■裡合ファイルスペック j は移勒すべきファイルを指定します。 

1 ■ぺス J はファイルの移®！先のディレクトリを指定し、これが措定され 
ないと*レントディレクトりが使月Iされます。•■パス j は r « 合•ファイルX 
ペック」屮の备ファイルスペックで参照されるドライプのそれぞれに存在 
していなければなりません。 

特定のファイルが衍定のあるいはカレントディレクトリ屮に移勒できな 
V、場合（例えばの名明のフ T イルがすでに存在するような場会）には 
そのファイル名がエラーメッセージとともに*示され> 移動*&理は次のファ 
イルに進みます。 

MOVE コマンドでは以下のスイツチが使えます。 


/H 不可册咸性のフ7■イルも移肋させます。 

/P 出力を1闲面ごとに停止させます。 

多くのエラーが起こる場合にこのスイッチを使います。 


T 




*>M0VE FILB1 ¥ 


ファイル TILE1J をカレントドライプのカレントデイレクトりからカレ 
ントドライプのルートデイレクトリへ移動します。 


*>K0VE m /P E:« COH ¥ 
COHHAND2.COH — D^ilicata fiUnana 


J 


*>MOVE /H /P E.*.CON * 

CO»W*)ID2.COH ― 77 ■イル名が* ft しています 


ドライブ E のカレントディレクトリ中の r *.COMj に通合するすべての 
ファイル（不可視フ 7 ■イルもそうでないフ 7 •イルも）をそのドライプのル— 
トディレクトリに移動します。 
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第 5 获 3 マンド 


フ7•イル COMMAND2.COM はすでにルーI•デ •< レクト U に#在するた 
めエラーが出力され^どちらの CCU1MAND2.COM も移勒も突®もされ 
ませんでした。 

/P スイッチが指定されているので、このようなエラーが多く起こってい 
た場合には、两が一怀になった段©でブ13ンブトが出力されて，キー人 
力を待ちます。 



* レントドライプ上の 1 " UTILj というディレクトリ中の f *COM_j あるい 
は r*.BATj に適合するすべてのファイルをそのドライプのカレントディ 
レクトリに移 M します， 
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MVDIR 

内9! コマンド_ 

[檐艇1 ディレクトリを問ーディスク上で別のディレクトりに移鈾します • 

[ft 式 I MVDIR [/H]|/P] 褀合フ7■イルスペック|パ叫 

'[解親丨 r « 合フ •? •イルスペック j は移# JI すべ$ヂィレクトり*併£します。 

2*0 のパラメータ（•■バス j) では移助先のディレクトりを播定し、こ 
れが抬定されないとカレントデイレクトリが«6用され i す。「パス j は「後 
合ファイルスペック j 中の ft フ t イルスペックで茶.明されるドライプのそ 
れぞれに#在していなければなりません， 

特定のディレクトリが指定のあるいはカレントディレクトりへ移肋でき 
ない場介««えば間--の名洇のディレク ！■ リがすでに存在するような場合> 
には、そのディレクトリ名がエラーメッセージとともに表示され^移 IW1 
琛は次のディレクトリに移リます。 

ディレクトリを下位ディレクトりへ移# ft する（そうするとサブデイレク 
卜りのッリー楙边が矛®します> ことはできないことに丄8して下さい。 
i れを劣 H しようとするとエラーとなります。 

MVDIR コマンドでは以卜のスイッチが使えます。 


/H 不 H 视ディレクトりも移勧させます， 

/P 1幽拥ごとに出力を伴止させます。 

エラーが数多く起こる場合にこのスイッチを使います。 



r COMj というデイレクト IJ およびその下にあるすベてのディレクトリと 
7T イルを r UTILj とい1ディレクトリ中に移動します。この場合、どち 
らのデイレクトリも々レントドライブの*レントディレクトリにあります。 



「COMj というディレクトリと r BATj というディレクトリ、およびそれ 
らの内容を r UTILj といつディレクトリ中に移勘します。 




ドライブ E の r DIR?j に逋合する（例えば D1R1、DIR2、DIR3 など）す 
ベてのディレクトリ（これらはこの場 ft 不可視のものであってもかまいま 
せん >、およびそれらの内容を r ALLj というディレクトリ中に移觔しま 
す。 r DIR2j というディレクトリは r ALLj 中にすでに存在するためエラー 
が出力されました， どちらの r DIR2j ディレクトリまったく影想を受け 
ません • 



5.3 コマンドの; ft 明 
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PATH 

L 内部コマンド _ 

[檐能^] COM および BAT ファイル検索パスを表示 St 定します， 


f » <1 PATH [;+ 卜脚パス [ [出]パス [ [山1ハ•ス,.肋 

w 说了 パラメータが析定されない i：、 租在の検索パス aa がセミコロン （;） で 

区切られて表示されます。 

r +j あるいは 1 "--j が播定されないと、検索パスは指定のパス名のリス 
卜に; aa され、既存の検索パスは削除されます， 

パスの0ストの前に r _j を 1 チえると、リスト中のそれぞれのパスが现 
在议$されている検索パスから削除され、《定のパスが??在していない項 
众にはエラーとなります。 

パスのリストの前に r+j を$之ると' 術定のそれぞれのバスが，まず 
(存在すれば）現在投定されている検索パスから削除され、それからその 
a 後に追加されます。これによって検索パス中のパスの ih 序を変 k するこ 
とができ、また a 在の検索パスの終りに新しいパスを追加することができ 
ます。+の構文を使用してひとつの3マンドで与えられるものよりも艮い 
検索パスを奴:定することができます，検索パスの最大 fi は255文宇である 
のに対しで，コマンドの*大 K が127文字であるため，コマンドラインか 
らは127文字しか入力できません， 

COM ま/こは BAT フ7■イルを検索する場合には，現在の検索パス中の 
パスが左から右へ ffi に使用されます， 

検索パス中のパスはドライプを含んだル—トディレクトリから始まる 
充全なパスで播定することが望まれます。そうしないとカレントドライプ 
やディレクトりが変わったときに、按粜バスの S 味が*わる可能性があり 
ます。 

検索パスは環境変数として保存されるので <8章「環境変数の玟定_|を 
参 SET コマンドによっても衣示•狡定することができます。 


[文例] 



COM あるいは BAT ファイルか次に検索される場 ft, 検索されるディレ 
クトリはカレントドライブの*レントディレクトリ、ドライブ E のルート 
ディレクトリ中ク） r C*Mj ディレクトリドライプ E のル_»■ディレク 
卜”中の 「BATj ディレクトりという期になリます。 
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パラメータが指定されなかったので、現在の検索パスが犮示されました， 



r A:¥COMj および 「A.¥BATj というデイレクトリが検索パスの S 後に 
迫加されます。 



| ;E:»CCH; E：yB*T； *;*CON; A.VB4T 
斯しい検索パスが衣示されます • 



r E:¥COMj および r E：¥BATj デイレクトりを現在の検索パスか削除 
します. 



铕しい検索パスをまた衣>丁<します， 





PAUSE 


内部コマンド 








RAMDISK 

内部 3 マンド 
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というブロンブトが&/了<され，データを K つて消去してしまわないよう 
に注念を促します。 

/ d を ma すると自觔的に既〇の ram ディスクは削除され，ブロンプ 
卜は表本されません。 

RAM ディスクを作成すると、ドライブ H として多照することができ 
ます。 

RAMD1SK コマ〆ドは通常 AUTOEXEC.BAT パ./チ7 r イル中だけて 
使用し、できる限り大きな RAM ディスクを作成するように人きな数姐を 
衍定するとよいでしょう。 

また RAM ディスクは停 S などのコンビ1~夕への*撖の陣害やリセッ 
卜で失われるため、7〇ッビーデイスクに保 fr されていないデータを RAM 
ディスクする«合には注；8；が必要です。 


A7KAHDISK 

RAMDISK-16K 



パラメータを指定しなかったためび在のサイズが衣示されます（この場合 
は1610, 


A>RAKDISX 






パラメータを指定しなかったが、 IIAM デイスクは作成されていなかった 
ためエラーとなりました。 


A>BAHDISK - 32 

HAK ディスク丄の全てのデータしますか ( Y / W ? 


RAM ディスクがすでに存在するためプロンプトが表示されました•ここ 
で IXJ を押すと、税 A の RAM ディスクは削除され、斯しい RAHIDISK 
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帝5¢コマンド 


RD 


内部コン 


「―《 *g I 


IU1DIR コマント•と W じです， RMDIR コマンド (P.133) を穸狀して T 

さい. 



5.3 コマンI••の说明 




REM 

内# コ，ン p _ 

[糨陡 j パ y チファイル中にコメントを入れます • 


この3マント‘はノ 1 ?ッチファイル屮にあっても.キーボードからコマンドと 
して入力しても何も行いません。 
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第 5 诠コマン！ •• 


REN 

内»コマント_ _ _ _ 

[棰能-1 RENAME コマンドと同じです。 RENAME コマンド （P.131> を茶照して 
I* •さい. 



RENAME 

内部コマント 
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第5京3マンド 


I *>RENAME B:*DIB1*».D0C/H/P ».DLD 
FXLE2.MC — 7T イル名が*換しています 



ドライブ B のルートディレクトリ中の DIR1 というディレクトリ中の 1 ' 
*.DOCj に適合するすべてのファイル（不可视フ t イルを含む〉を同じ主 
フ7■イル名で fc 張子が .OLD のファイル名に変更します-ディレクトリ中に 
すでに FILE 2.0 LD というファイルが存在したため.ファイル FILE2.DOC 
は名前を変 K できずエラーが表示されました。 F1LE2.D0C も FILE2.0LD 
もまったく変—史を受けていません。 /P が指定されているので、エラーが 
多 < 出力された場合、1_而ごとに停止してキー入力を待ちます- 


▲>REMAKE DOC + FILE1 •.OLD 


DOC というデイレクトリ中のすべてのフ r イルおよぴフ r イル FILE1 (ど 
ちらもカレントドライブの*レントデイレクトリにある）のフ7•イル名を 
拡强子. OLD を持つものに変 e します。 



RMDIR 

内 SI! コマンド 

I 檣箱 I ひとつあるぃは換数のサブディレクト IJ を削除します》 

I卉式丨 RMDIR [/H||/P| 褀合フ7■イルスペック 
または 

RD (/H][/P| 梭合ファイルスペック 

[ « 5ii ] r a 合ファイルスペック j で別除すべきディレクトリを併定します。 

ディレクトリを削除するためには、常にディレクトり中に含まれる特殊 
な r .j および* '.. j という特殊なディレクトリ以外にファイルやディレクト 
リを含んでぃてはなりません。これらの特殊なディレクトリは新しぃディ 
レクトリが作成されるとき fl 助的に®かれ、削除することはできません， 
これらは新しぃディレクトリが作成されるときに的に作成され、こ 
れにより、パス名中で「.ム r ..j によって、それぞれカレントディレクト 
リ、親ディレクトりを指定できます（バスの記述につぃて fi、5.1 •■この皋 
の表 2C 法 j を赛.照)。 
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RNDIR 

内部コマンド_ 

j_at_ 能I ひとつあるいは裡数のサブディレクト u の名前を突 k します。 

[•» 式| 1«'10111|/11||/?|複合ファイルスぺ-ノク7 7'イル名 

[解说] r S 合77■イルスペック J で*南を*8!す4ディレクトリを指 t します， 

ディレクトりの内容 fi 変更されません。 

2番 fl の「フ t イル名」はディレクトりの斬しい名 H5 を指定します，祈し 
い名萌の中で 1 '?」を柑定すると、変更を受けるディレクトリ名の対応する 
义字が?あてはめられ、7イルドカードを含むディレクトリ名 （P.60 のフ r 
イル名についての紀述を参照）で変史が可能となリます。2番目の•■フ T 
イル名 J で 1 '* J を使用すると、これはすべての文字を*'? J と指定したも 
のと冏等なため、ディレクトリ名のファイル名あるいは拡® f 全体がその 
まま変 KS れずに残ります。 

何らかの理 IH で特定のディレクトリの名前が変更できない場合、例えば 
斯たに栴定した名前と P1 じ名 m のファイルまたはディレクトりがすでに# 
在する場合、そのディレクトリ名が エラー メッセージとともに衣示され 
名前の変 E の処理は次のディレクトりへ進みます， 

RNDIR コマンドでは以下のスイツチが使えます。 


/H 不可枕 IR •注のデイレクトりの名 IH も変 fi します。 

/P 出力を1面 C ごとに停止させます。 

多くのエラーが起こる場合にこのスイッチを使います。 
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第 5 章コマンド 


ドライブ A のルートディレクトリ中の DIR? ■本にマッチするすべてのディ 
レクトリ（不可視デイレクトリ fc そ")でないディレクトリも）を. OLD とい 
う拭强•チを持つものに名麻を変更します。 DIR1-0LD というディレクトり 
がすでに存在したため.ディレクトリ DIR1 の名前は*更できず、エラー 
が表示されました， エラ--が数多く起こる場合には、 /P によって1阐面 
ごとに表示を停止します。 



COM および BAT というディレクトリをそれぞれ COM.OLD、BAT.OLD 
に名 IK を変 K します。 



5.3 コマンドの说明 
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SET 


内部コマンド 


[機能^) 環境変数を在示•設定します。 


SET [名前 H セパレータ||値] 


解 all I パラメータが指定されないと現在£典されているすべての53境変数とそ 

の値が表示されます。初期状態ではデフォルトの姐に設定されたいくっか 
の* HR があ 1 )ます （8 章「環境変数の》定』を参厢>, 

1 ■名前 j だけが播定されると、その®埃変数の現在の伍が表示されます， 
•■名明 J の後に 1 ■セパレータ j が报定された場 ft、r セパレ_夕』に統く 
値が名前に設定されます • <£が与えられないとその琛塊変数は®壤領域か 
ら削除されます， 

環境変数に使用されるメモリ領域はディスクパッフ7■としても使用されま 
1,したがって SET コマンドを使用していて r not enough memory j r / 
モリー不足です j エラーが起こった場合には、ディスクバッファの数を滅 
らすことで対知:できることがあります （P.76「BUFFERS」 を参照)。 

8章では®境変数についてのより詳細な情報やデフォルトで胶定3れて 
いる ft などが記述されています》 




例 


REDIR-ON 

UPPER-OFF 

ECHO-QFF 




KHELP-AtVKHELP 


HEU>-*:»HEU> 


•»er.2 30から追加された®境変数 


パラメータを指定しなかったため、すべての現在》定されている®境変数 
が表示されます（この場合は、デフォルトの®)。 



SJ 境変数 HELP の値を A:¥HELP に设定します。 




*>SET HELP 


HELP の現在の値を衣示します。 



SJ 境変数 HELP の値を»定しないと，変数のリストから®境変数 HELP 
を除去しま1% 



空 h タブ 


これら文字のどちらの侧にも空〇が米てかまいません。人力を w 略 
た数侦は現在の a 定が使 m されます。 ww のは時刘、 2# b が分， 

目が秒、4 が1/100秒です。しかし、1/100秒について UW 在の値を 

たり、新たな tt を入力することはそれほど役立つことではないため 
表示はされません， 

時刻が衣示される形式は固定されておらず、変史することができます。 
という泣境変数 （15 堍変数について148京を参照）はデフォ. 

「12j 定されておI)、これは時刻が12時 M 形式で*示され、 

前と午後を*すのに後に 1 "aj や 「PJ をつけることを示しています。 

マンド SET TIME 24によって、時刻は24時間 モー ドで表示されま 
時刻はどちらの彩式でも入力することができます。時刻の形式は DIR 
ンドによって表示される時刻にも影®を与えます。 



第 5 章コマンド 




«在の時*)は 10 : 4S:00a です 
新しい時刻を入力して TS い： 


パラメータを与えなかったため、現在の時刻が表示？れ（この場合は12時 
1«モードで K 新しい時期のブ〇ンブトが出力されました， 



時刻を午前10時50分30秒に K 定します。 




S3 3 マントの 31 明 


141 


TYPE 

内®コマンド_ 

[描能| フ r イルまたはデパイスからデータを表示します。 

「 & 式 ]TYPE [/H||/P][/A][/B| 椹合7 7•イルスペック|デパイス 

[W J)i ファイルスペック j は表示するファイルを柑定します。 1 ■棋合 7T 

イルスペック j にワイルドカ'-ドを使用すると、それぞれのファイルが表 
示される前にそのファイル名が出力されます。 

TYPE コマンドでは以下のスイッチが使えます。 


/H 不可 tt)S 性のフ r イルも*示します。 

/P 出力が I® 面ごとに停止し、キーが押されるのを待ちます。 

/A T スキーフ7•イルとして扱います（デ7ォルトです)。 

/B バイナリファイルとして扱います。 

7 r イルの終りに達するまでデータがそれぞれのファイルから SC ま 
れて画面上に変更なしに表示されます。77•イルが：！ント ロー ル文 
字を含む場合は、 1*1 而上でおかしな®作を兑せることがあります。 


/B が报定されないと、 TYPE はエンドオプフ7•イル文宇 rz> を探し 
それを見つけると停止します。また、改行、およびタブを除く； J ン 
トロール文字は表示可能な文字（例えば、なら"と A という2文字， 
~W なら~と W という2文字）に変換されます。 


[文例 



FILE1 という 7r イルを最初のエンドオプファイル文字まで画面に*示し 
ます。 



不可视であるもの <> 含めすベてのパッチフアイルを銪み込んで表示します。 
1画面ごとにブロンブトが表示されて停止します。 
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ファイル AUTOEXEC.BAT および REBOOTBAT を表不します。 



ディレクトリ DIR1 中のすべてのフ7•イルを、ファイル中のデータを変換 
を行わずに画曲に表示します。 



UNDEL 

外部コマント_ 


[梭能」 UIW に #] 除されたファイルを抱话します， 


「涔 ^ ] UNDEL [ファイルスペックI 

[解； i 1 r ファイルスペック j には fe 活したいファイルもしくはディレクトリを 

衍尤します。指定されなかった場合 li*.* となります。 

フ7■イルは MSX BOS2 フォーマッ（•のディスクで MSX DOS2 を他用 
して削除されたもので、ファイルもしくはデイレクトりが削眈されてから 
そのディスクに何か?込みを行う前であれば»话できます， 


削除されたディレクトりおよびその下の削除されたフ7•イルなどを彳 k 活 
するには、まずディレクトりを UNDELJfi、 次にその下のフ T イルなどを 
UNDEL します。このと S. すべてのファイルなどを UNDEL する埯合は 
ディレクトリ名のみを指定すればよし r ¥*>j は B 略できます， 


1 


«>UKDEL B:HELP.K«C 


ドライブ B のカレン！•デイレクトりからフ f イル HELP.X+IAC を fit 活し 
ます。 



DIR1 を ftiiS します • 





D1H1 中のすべての供话な 7 7 •ィルおよびディレクトりを«活します* 
この場合， r FlLEU と r FILE2j の2つのファイルが极话できたことにな 
0ます. 



53 コマント•の说明 




VER 

w ® コマンド_ 

[檣能丨 システムのパージ9ン番•号を表示します。 


| S 式 j VEK 

「解说] MSX-DOS ディスクシステムの3つの中-なシステムプログラムの••、•一 

ジョン番号が表ポされます，どのパージ s ン番蛉も3つの a 字で構成され 
ます。 

ft 初の数字は MSX DOS のキ•パ_ジ3ン番兮で、 MSX »«S2 の場合は 
常に2です。 

2番 U の数字はパージ a ン#号で、例えば®要な檐能が追加された增合 
は変_史されます • 

最後の数字はリリース»皆で、マイナーチ*ンジ、改良や修Iが行われ 
た場合に*0ます- 


I MSX-DOS Karsel version 2.30 
| MSXD0S2.SYS vsrsion 2.30 
C0MMAND2.COM versioa 2.30 


ディスクシステムのバ—ジ a ン番号を出力します。 
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VERIFY 

内部コマント___ _ 

[ « 能丨 视舟のディスクの SJ 込みべリファイの 4X28 を表示 • S 定します • 


[暑式 I VKRIFY |OK| OFF| 

[解 iit I パラメ-.夕をVえない* Sft， のべりフアイの状®が内而1■.に农ポさ 

れます， 

ON あるいは OFF をすると、ベリファイの状雄が変®されます- 
ベリフ7■イの状! i はディスクへのすべての杏き込みに釤?¥を-*/えます。 
OFF の状態ではデータは単純に*き込まれます。 

0-N の場合、デ-夕が#き込まれた後でそれが成み込まれ、元のデータ 
と1匕校され. iR しく啬き込まれたかどうかを ffiig します。このオーバ^ッ 
ドによって，ベりフ7■イが ON の坩介にば込みは ffl くなリます。 

この»能はディスクドライパに依存するため、ドライバがベリフ r イ拽 
能をサポートしていない場合は意味を持ちません c 

[文例] ( 、' 

- • ▲> VERIFY 

VERIFY-OFF 


パラメータを与•えなかったため、 Odfr: のべり7ァイの状態（この場合は 
OFF) が表示されます， 



デイスク备き込みべりフ7•イをオンにします。 



5:1 コマンドの说1>月 
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VOL 

内部コマンド__ 

[檐 （8 1 ■ ューム名を衣>7：.変史します • 

[ff « 1 VOI パ d：j| ポリューム名 j 

[解 d 丨 パラメータを指定しない場もしくはドライブ名だけを指定した場 

合、カレントドライブあるいは指定のドライプのボリューム名が*习'され 
ます。 

•■ボリュ-ム名 j を梅定すると、カレノトドライブあるいはす院のドラ 
イプのボリューム名が、衍定のボリューム名に変®されます。 
r ボリューム名 j は,'ふ太、竽角11文字もしくは全角5文卞てす， 



ドライブだけ指定したため、そのドライプ中のディスクのボリューム名が 
表示5れます。この場合、ボリュ-•ム？••は定箱されていません • 



ドライプ B のボリューム名を fBACKUPj に変史します。 
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XCOPY 

外部コマンド___ 

[檐能丨 ディスクのフ7■イルおよびディレクト IJ を別のディスクにコビーします。 

L 卉式 I XCOPY|"77 •イルスペックIファイルスペック 11[/H1(/T|[/A][/M][/S][/E1 

I/P][/W][/V] 

[w I xcopy は拡張されたフ 7 ■イルコビーコマンドで、ファイルとディレク 

トリの両方を運択的にコビーすることができます (P.88 r COPYj を參照 h 
ft 初の 1 ■ファイルスペック j ではソースファイル名を播定します， 

2番 H の r 7r イルスペック」は：》ビ_先のフ t イル名です。したがって 
ファイルはコビーを通して名前を変 g することができます（檷準の COPY 
3 •^ンドと問様）〇 

XCOPY コマンドでは以下のスイッチが使えます。 



5.3 3 マンI•■の a 明 




/H 不可視 ttil: の7 7•イルもコビーします„ 

/T コビーされたフ T イルの R 付と時間はソースファイルのものの代わ 
9に現在のものとな 1 J ます。 

/A 「ア _カイブ_辑性が セット されている7?•イルだけがコピーされ 
ます。ファイルは、•■不可视 j «性および「较み m し存坩」 * 性と同 
様にアーカイブ®件を持ちます。これはファイルが更新された（卉 
き込まれた）はいつでも奴:定されます • 

/M /A と PJ 様ですが，ファイルをコビ-した後でア ー* イブ成性をリ 
セットします • したがってこのスイッチを使用すると、ファイルが 
史新された場介にだけフ7•イルを利のディスクにコビーすることが 
でき、フ7•イルの効率的な ハ•ヴ クアッブが可能になります， 

/S ファイルをディレクトリごとコビーします，それぞれのディレクト 
リ内で*合するすべてのフ r イルがコビーされ、さらにその下に 
あるサブディレクトリとその中にあるフ7•イルもコビーされます。 
コビー先のディスク上にディレクトりが存在しない場合には、その 
ディレクトりが作成されます，コピーの籴件に滷余するファイルを 
持たないディレクトリは作成されません。 

/E /S スイッチが ffi 定3れているとき、 /E スイッチが播定されると、 
コピーの条件に；*合する7ァイルを «■ たないディレクトリであって 
も作成されます。 

/P それぞれのフ r イルをコピ-する《に ff 止し、そのフ7•イルをコ 
ビーして良いかどうかを W いてきます。これによって、ファイルを 
进択してコビーすることができます， 

/W コビーを始める前に停 ih しブロンブトを出力するため、ディスクを 
人れ換えることができます • 

/V XCXJPY コマンドの热理.の！«、ディスクドライパがベリフ7•イ機 
能を持っていれば#き込みチ*ックを行うことができます (P.146 
r VERIFYj を蜜照>。これによってデータがディスクに£しく*き 
込まれることが保 a されますが，*5理にかかる時間は增加します。 


I *>XCDPY B：y I 

ドライプ B のルートディレクトリ中のすべてのファイルを々レントドライ 
ブの々レントディレクI•リへコビーします，この場合は、標參で紐み込ま 
れている COPY コマンドを使用する以上のメリ ッ トはありません， 
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XDIR 

外部 コ v ント_ 

[^槌能 j ディレクト”中のすべてのファイルのリストを衣ポします。 
f - S 一"''式 - 」 xi>m |77■イルスペック1【/川 

[SW »!i 1 ■ファイルスペック j で衣ボするフ7•イルを ■)?；£ します， 

XDIR は DIR コマンド t 類似していますが、フ7 ■イルのと時 I和を衣 
W しません。 

指定のディレクトリ中のすべての7ァイルがリスト3れると、下にある 
サブディレクトリ中のファイルもインデントを付けられてリストされます。 
これによって完全なディレクトリツリーあるいはディスクのフ7■イル' 
K を取ることができます。 

DIR コマンドでは以下のスイッチが使えます， 

/H 不可 IJI ファイルを*ポすることができます。 




例 I 


Volima in drive A. is MSX-DDS 2 
X-Directocy of A:¥ 

MSXDDS2 SYS r 4B70 

CDMMAND2.COM r 15472 

AUTOEXEC. BAT 57 

REB0QT.BAT 57 

CHXDSK.CDH 

OISKCOPY.COM 

FIXDISK.COH 

UHDEL.CW1 

XCDPY.CMI 

XDIR.COM 

HKSYS.BAT 


ASSICN.HLP 

ATOIR.HLP 

ATTRIB.HLP 


392X in 117 files E30K free 




ューム名 l:t MSX-D0S2 


MSXD0S2.SYS 

conwn>2.coK 

*umXEC.8AT 
RE 8001.8 AT 


DKDEl.COM 

XC0PY.C0H 

UDIR.COH 

HKSYS.8AT 

AUTOEXEC.BAT 

REBOOT. 8AT 


カレントドライブのカレントデイレクトリから下のデイレクトリをすベて 
表示します。 


A>XDIR B：¥DIR1 


デイレクトリ DIR1 中のすべてのフ7•イルとサブデイレクトりの内容を表 
示します。 



r *.COMj に適合する不可视フアイルを含むすべてのフアイルの名前を表 
示します。 
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リダイレクションとパイブ 


COMMAND2.COM は、以下に述べるリダイレクシ3ンおよびパイプの拽能を提供してい 
ます。ただし SI 境変数 「REDIRj を r SETREDIR=OFFj コマンドなどで 「OFFj にセッ 
卜すると、この機能は働かなくなるので、 MSX-D0S1 や CP/M との： S 換性を保つことがで 
きます。 


6.1 リダイレクション 


大部分のコマンドは CP/M ブ〇グラムも MSX-D0S ブログラムも「樣准出力 j へ書き出 
すことによって画面にテキストを出力し、>■標準入力 j から«むことによってキーボードか 
ら班み込みます。しかし COMMAND2.COM はコマンドを実行している問だけ、標準入力 
と榡準出力を他の MSX-DOS デバイスやディスク上のファイルを参照するように、変更す 
る機能を提供しています，これは、コマンド行1=リダイレクション妃号••<_)、 r >J> および 
r »j のうちの1つ以上を含めて、その後にファイル名を S くことによって可能になります。 

例えば、 ECHO コマンドは標堆出力に文字を出力することによって、文字列を画面に表示 
するだけですが，その出力を次のようにリダイレクトすることによって、その代わ0にプリ 
ンタに出力を行うことができます。 

ECHO text > PRN 


これによって ECHO コマンドの実行中に*準出力がデパイス PRN を参照するように変 E 
できます， 


ECHO text > filel 


间様に、この：!マンドによって FILE1 という名前のファイルが作成さ it* ECHO 3マン 
ドの出力がファイルへ書き出されます。また、 r >j £号の代わりに「>>_)記号を使うと、： j 
マンドの出力を既存のファイルに追加することができます。指定された7アイルが存在しな 
い場合にはファイルを作成します。 
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掠*入力を® ffi するに U, 1 ■ぐ） idS を 「>j aiy- と R 様の方法で tt 用します。この找合 
ファイル (i 既存のものでなければならず、コマンドに対して適«な人力が含まれていなけれ 
ばな0ません。コンドがフ7■イルの終わりを越えて人力を-*もうとすると、枝行できない 
ためコマンド (i 打ち切られます。 

コマンドけにりダイレクション W 報が指定されると、それは COMMAND2.COM が IJ ダ 
イレクシ3ンをセ-/トァ ••/ プするために使い、コマンド行からは除 ii されます。したがって 
I妃の例では、 ECHO コマンI••はリダイレクシ 3 ン記号やファイル名をエコーしません。 

ハ •/ チフ7•イルの入力や出力がりダイレクトされると、りダイレクションは/チフ7■イ 
ル卬のすベてのコマンドに対して適用されます。ただしハ*ッチフ7•イル中の倘々のコマンド 
でリダイレクシ3ンを使用することも "f 能で、この場合パッチファイルに対してのリダイレ 
クン s ンに充します • ハ*ッチファイル中のコマンドにつ!■、て详しくは7章し <y チファイ 
ル J を杏照してドさい ■ 


6.2 パイプ 

コマンドやブログラムの人出力を、他のデバイスやデイスクファイルに W してりダイレク 
卜できるのと岡様、ひとつのコマンドの出力を刖のコマンドの«绝人乃ヘリダイレクト， 
すなわち 1 ■バイブ j ができます。 

一般には，2番 h の3マンドはそれの橡电人力から a み込んでデータを修正し、それ 
をそれ1=1身の標準出力へ啬き川すブログラムです • このようなプログラムは 1 ■フィルタ J と 
呼ばれます。例えば、フィルタは樣準人力からデータを«んで、それをアルフ7■ぺサト*に 
ソートし、それを標準出力に并き; h すといったことができます。したがって DIR コマンドの 
出力をソートすることもできます。 

パイプはコマンド tif- •で2つ以卜•のコマンドを「I」3己9で区切ることによって併^しま 
す。 「|j S 己号の左俩のコマンドが»切に实行され、その力が COMMAND2.COM によって 
一時的に作成されるテンポラリフ7•イルにリダイレクトされます。それから2恭 B のコマン 
ドがその人力を财—のテンボラリファイルからリダイレクトされて其行されます。2 »• 
H のコマンドが終！•すると、テンポラリファイルは啪除されます。 2»H のコマンドの棵準 
出力を、3 SB のコマンドの標準入力へパイプしたり、さらに（別のコマンドに）«けたり 
することももちろんできます。 

バイブを含むコマンド行で人力のリダイレクV 3ンが起こると、I)ダイレクシ3ンはパイ 
ブの a 初のコマンドに対して通用され、その他のコマンドはその梅咿人力を/<イブの®前の 
コマンドの樣準 m 力から受け取ります。 PMt に、パイプを含むコマンド行で出力の y ダイレ 
クション* MR 定？れた坳介には、その 1 )ダイレクシ3ンはコマンド行の R 後のコマンドに対 
して適用されます。 

パイブをパッチファイルの人力または出力のどちらかで直接使うことはできません〇しか 
し、 COMMA.ND2 コマンド （P_84 r C0MMAND2j を参照）から实行するならばパ/チファ 
イルでパイプを使用することができます，なぜなら、その場合■リダイレクトされるのはハ y 
チファイルではなく COMMAND2 コマンドだからです。 
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のように、ひとつのコマンドの出力を他の人力へパイブするためには.テンポラリ 7T 
イルが C0MMAND2COM によって作*され、削除されます-これらのテンボラリ7 7•イ 
ルの埸所は •〖 kmp 潭境変数（8¢ の; a 定 j を餐照）によって指定され、これは他 

のトライプやディレクトリを害月《するように変圯でさます，例えば TEMP が RAM ディス 
クI•のティレクト”を参照していれば，パイブはかなリ速になります。デフォルトでは 
TEMP はプートデ•（スタのルートデイレクトリになつています。テンボラ M 7ァイルに使 

用される7ァイル名は COMMAND2.COM によって作成されるため. TEMP はドライプと 
ディレクトリだけを栴定しておきます。テンポラリファイルのフ t イル名は;欠のような形 
とな 1 J ま_»% 

'XPIPExxx.SS* 

ここで xxx は3桁の数字で、 TEMP デイレクト U 中の他の7ァイルと#!突しないように 
COMMAND2.COM によって遵択されます. 



バッチファイル 


コマンドが MSX-DOS に与えられ、それが内部コマンドでない場合、その名前で拡*子 
が COM または BAT のファイルが検索されます„カレントディレクトリ中で見つからない 
と、現在の梭索パスが参照されます （P.121 fPATHj を参照し COM ファイルが見つかる 
と口ードして実行します。 BAT ファイルが見つかると、 MSX-DOS はパッチファイルの 
其行を開始します， 

パッチファイルとはコマンドのリストを含むテキストファイルであり、これらのコマンド 
は一時に1行ずっファイルから较み込まれて、あたかもキーボードから入力されたかのよう 
に实行されます。 5* マンド j で说明したコマンドのうち、 ECHO や PAUSE、IF など 
は、主としてパッチファイル中で使用するために用*されています。 

それぞれのコマンドが嫌み込まれると、通常即座に実行されます，ただし ECHO という 
環境変数を r SETECHO ONj 3マンドを使って 「ONj にセッI•すると、各コマンドの実 
行前にコマンド行自体を画面上に8示することができるようになります （8 章の«墳変数に 
ついての E 述を参照)，コマンド行はその場合、ラメータの代入（後述）が実行されてか 
らエコーされます，コマンド 「SET ECHO OFF j は、これを通常の状®に戾します， 

パッチファイルを起動するコマンド行では、他のコマンドや外部ブログラム名と同嫌パラ 

メータをパッチファイルの名前の後に嫌けることができます。これらのパラメータは％〇~%9 
を播定することによって、パッチファイル中のどこからでもアクセスすることができます。 

がコマンド行で指定される最初のパラメータで、％2が2番目のパラメータなどとなりま 
t. %0はパッチファイルそれ自身の名前です。％»字は元のコマンド行のパラメータで E き 
換えられ、パッチファイル中のどこででも使用できます。コマンド行で実際に 「％j K 号を 
使用するには、2っの％ ( r %%j) を与えなければならず、これ.は単一の％に変換されます • 

また、環境変数名の前後に％を付けることによ0、田境変数をパッチ中に取り込むことが 
できます（これは、 ver.2.31 から追加された檐能です)。％現境変数名％は琛境変数の設定値 
に引き換えられ、ッチファイル中のどこででも（パッチファイル中に限らずコマンド行で 
でも）使用できます。 

パッチファイル中のコマンドの実行がなんらかの理由で中断された場合(特に (CTRL) + 
「STOP] や ICTRLI + IC| が押された場合)，次のようなブロンブトが出力されます， 
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j^Terminato batch file Of/N)? 


バ，チ姑岬を中 il し i +か «/»)» 


これに対して！ "Yj を？？之ると、パッチフ t イル全体の•期7が fril •します。応答が 「N_J で 
あると、バッチフ r イルの尖行はパッチファイル中の次のコマンドから 
K 行されます。 

MSX DOS かパッチファイル中のコマンドを V6 行し終ると，パ-/チフ7•イル中の次のコマ 
ンドをディスクから陳み出さなければならない場合があります。その場合£しいディスクが 
卜•ライプ屮にないとブロンブトが出力されます。例えば、パッチファイルが fii 初ドライプ A 
から其行された壤会、次のようなブロンブトが出力されます。 


Iパ/チフ T*f ルの入ったヂ< Xクをド，イブ▲:に入れて 
| W かキーを押して！>さい. 


il: 上いディスクが神人され、キーが押されると、パッチファイルの文行は正常に統行します。 
W ドに示すのは井®になバ7チフアイルであり、最初のいくつかのパラメータを表示 
するだけのものです。 


ECHO Parameter 0 = 
ECHO Parameter 1= 
ECHO Parameter 2 = 
ECHO Parameter 3 - 


%0 

%1 

%2 

%3 


これを MYBAT.BAT とすると、 3 マンド MYBAT abc は下の出力を行います。 
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Ai 初に MSX DOS が teill されると、 AUTOEXEC.BAT という特殊なハ•ソチファイルが検 
索され、もしあれば実行されます。これにはどんな MSX-DOS コマンドを含めても设く、そ 
の中には RAM ディスタを,设定する RAMDISK 3マンドのように、文ち上げ時に1 !J£ だけ 
艾行すればよI•初期化コマンドなどを指定しておくと便利です， 

この場 ft 、AUTOEXEC.BAT にはひとつの％パラメータが％Iとして®されます • これは 
MSX D 參 S か起#力されたドライプ名で、口 〇ンが後に付いた通常の！••ライプ名の形を取り 
ます。 

もうひとつの枓»なパッチ7 7■イルは REBOOT.BAT です。これは、 DiskBASIC を使 III 
した後で、 MSX 卩 (>S が冉起肋されると3に尖行されます， AUTOEXEC.BAT フ r イルと 
M 樣、 MSX-BOS が枓起姑したドライブか"％1パラメータとして®されます • 

W 初であれ、2 以降であれ、 MSX-DOS を起*IIするときは、通! B いくっかのコマンドを 
其けする必要があり、これらを REBOOT パッチファイルに入れておきます。それらは、 AU¬ 
TOEXEC ッチフ t イルをコマンド REBOOT %1で終らせることによって、 AUTOEXEC 
パッチファイルから戈行することができます。 REBOOT パッチファイル中に入れておく 3 
マンドの一例は，外部コマンドの検索パスを a 定する PATH コマンドです • .このコマンドを 
使用して検*パスを攻定する場合、を使用して、どのドライプから起助しても正しいパ 
スを a 定することができます。 

バッチファイル中のコマンドが別のパッチファイルの f；fiK •ある場 ft、 2番 H のパ/チフ r 
イルが級いて夹行されます。それが終了すると、制御はコマンドインタ—プリタに K り、 it 
初のパッチフ7■イルには»りません • つまリ、ッチコマンドは 1 ■チ * イン j しまれ 
バッチフ7■イルを•'ネスト」する、つま9 1:3d の場合に W 初のパッチ7 7■イルへ制抑を K 
すには、 COMMAND2 コマンド (P.84 rcOMMAND2j を参®!)に、 2SH のバッチファ 
イルの名前をパラメータとして®します。その場 ft、2*H のパッチファイルが終/すると 
A4 初のパ •/ チフ7•イルが C_MA1AND2 コマンドの後のコマンドから*&けちれます， 

-般的な AUTOEXEC パッチフ t イルの例を次に示します • 


ECHO AUTOEXEC executing 
RAMDISK 100 
RAMDISK 

COPY COMMAND2.COM H：¥ 
REBOOT %1 


-般的な REBOOT バ y チフ 7 ■イルの例を次 K 不 • します。 
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第 7 彦パッチフ r イル 


ECHO REBOOT executing 
PATH H.¥,%I¥I TILS,%I¥BATCH 
SET SHELL=H.¥COMMAND2.COM 
SET TEMP-H:¥ 

SET PROMPT ON 
H: 


AUTORXEC パッチファイルが実行されると、 「AUTOEXECexecutingj のメッセージを表 
ポし， RAM ディスクを Jfc*：100K で狡：£します。次に別の RAMDISK コマンドで作成された 
RAM ディスクの* BS の大きさを表示します，そして COPY コマンドで COMMAND2.COM 
を RAM ディスク上にコビーし、再口ードを高速にできるようにします。最後に REBOOT 
パッチ 7T イルを起 W し、それに％1パラメータ（ブートドライブ名）を»します • 
REBOOT パッチファイルはメッセージを表示し、それから PATH を》定します，パス中 
の fi 初の項9は AUTOEXEC パッチフ r イルで作成3れた RAM ディスクを參•明しており 
その他の項 H は MSX DOS がブート5れたディスク（つまり％ 1) 中のディレクトりを参照 
しています。次に COMMAND2.COM が RAM ディスクから高速に - ドできるように 
SHELL® 墳«数をセットアッブし、 RAM ディスク上にパイブファイルを作成するよう K 
TEMPSPft 変数を»定します。最後に PROMPT を ON にセットして、カレントディレクト 
リがブロンブトとして*帀されるようにし、 RAM ディスクを《レントドライブにします。 



環境変数の設定 


MSX DOS は r S 境変数 J のりストをワ-クエリ T 内に； e« しています • am 変数とは 
名前があってそれに関*した«を持ったものです。 

斑境変数の名前はユーザーが仟«に a 定することができ、フアイル名で使用できるのと同 
じ文字を使うことができます。最大：6は255文字です。 MSX-DOS はデフォルトで設定され 
るいくっかの ffl 埃変数を用意しています • 

«境変数の M は最大 ft 255文字までの任意の文字からなる中なる文字列です。文字にっい 
てはいかなる処琛も実行？れないため、大小文字の利は保存されます。存在しないすベて 
の ffl 境変»はヌル値を*る（つまり文卞がない）ものとされます。 

現境変数は SET コマンドによって变更あるいは设定できます。また、これによって稅在 
設定されている琼堍変数を表示することもできます。 

デフォルトで a 定されている«境変我と、それらの値の解釈を以下に铊します。 

なお、2.30 jtl. vet.2.30 で追加された SS 境変数であることを®味します。 


8.1 環境変数の説明 


1«2 558 ?頊境変数の 


はカレントドライプの々レントディレクトリを a むためにディスクをアクセスしなけ 
れぱならず、したがってプロンプトが現れるのにはその分時118がかかります。 

• PATH 

COMMANM.COM が J j •えられたコマンドを検索するための検由バスは、 S 境变数 
PATH として保 ft されており、 PATH コマンドにより揉作されま t。 

• SHELL 

S3 境®数 SHELL はどこにコマンドインターフリタ (COMMAND2.COM) が frfr. す 
るかを示し、デフォル！•ではそれが〇_ドされたところにセットされています。 

コマンドインタープリタが外部コマンドを尖行した後.それをデイスクから再ロー 
ドする必要がある場合それは®境変数 SHELL を期べてそれが示すファイルから自分 
a# を d — ドしようとします。これがエラーになると、41初に〇— ドされたドライプ 
のルートディレクトリから〇—ドしようとします- 

コマンドインタープリタを别のドライブやデイレクトりから再ドさせるために、 
COMMAND2.COM をコビーして SHELL をそこから窬照するように定することが 
できます。例えば、それを: J マンド COPY COMMAND2.COM H:¥ で RAMDBK I： 
コビーしたとすると， SHELL は：!マン SET SHELL=H:¥COMM AND2.COM で;9； 
定します。 

• TIME 

TU1E は MSX-D0S によって衣示される時刻の形式を ffi 定 L ます。 r 24j (24 時問形 
A で衣示する）でない場合には、 r 12j と解釈されますが、これは12時問形式に午前 
T •後の表示を加えて S 示するものです。 

時刻の入力は、どちらの形式でも入力しても区別でさますので、 SWI 変数 TIMEU 柄 
找されます。 

• DATE 

DATE It MSX-D0S による El 付の表ボと入力の形式を指定します。デ7ォルトではそ 
の MSX マシンが使 fl] される团に合わせてあります《それ14、日 M ■•時刻のセパレータ 
で K 切られた3文 f あるいは3組の文卞の形式を取ります （P.92「 DATEj を参 M)。 
例えばアメリカ形式にセットするにI久コマンド SET DATE=MM/DD/YY を入力し 
ます。 

• HELP と KHELP ([2.30 1) 

HELP コマンドにヘルプが必耍なコマンド名を指定すると s HELP. KHELP5I 境に 
よって指定されるディレクトリからファイルが统み出され表示されます。 

HELP コマンド•其行時に， HUM モー ドに応じて ANK モート，ならば HELP で指定され 
るディレクトリを、漢字モードならは KHELP で指定されるディレクトリを自®的に 



8.i ® 境? ea の说明 
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逛択します。それぞれテ7オルトは MSX DOS が起 W された!••ライブのルートディレ 
クトり i| ■の HELP, KHELP というデイレクトになっています- 


APPEND 

APPEND はデフォルトでは定«されませんが、«定されるとンステムに対して待別な 
SW •のある谋境受致となります。これは C： ゆの CP/M ブ〇グラムとともにだけ使用さ 
れます。 


CP/M にはサブディレクトリがなく、々レントディレクト IJ に相当するものしかない 
ため、 CP/M プログラムはサブデイレクトりの使用法を知りません。このよ')なブロ 
グラムがファイルをオープンすると、それはこのただ1つのディレクトリ中だけを検* 
します。つまり、1••ライブとファイル名だけを待っていてパス名を持たないわけです， 
CP/M プログラムが MSX DOS の下て-/されファイルをオープンしようとすると. 
拊定されたドライブの々レントディレクトり中でしかフ T •(ル？!が梭索されません。间 
從に、ユーザーが CP/M ブ〇グラムにファイル？;を入力する場合、ドライプとファイ 
ル f •しか柑定できず、つまりは、カレントディレクトリ中のファイルのみが窬照され 
ます。 

この検索が MSX DOS を通して実行される埸合、フ7•イルがカレントディレクトリ屮 
で見っからないと、次に APPENDS 境® R が39ぺられます。それが®定されていな 
いと、ファイルは S っからなかったとします。されていると、それはパス名とし 
て解农され、ファイルの検索を技けるもうひとつのディレクトりを指定します • 

これ li、CP/M ブ〇グラムがファイルをオープンしてそれを M み#きする堪合にのみ尨 
味を持ちます。例えば、ファイルを№1除あるいは作成しようとした場合には APPEND 
は使) li されません • 灾際 APPEND は望ましくない効采をじる可能性があるため 
APPEND は遍常:パッチフ7•イル中だけで使用し、パッチフ7•イル巾で APPEND をセ/ 
卜、 CP/M ブ〇グラムを变行、そして解徐といった手®で使用するのが良いでしよう， 
APPEND の代衣的な使われ方としでは、大 S なブ〇グラム（<7-ドブロセ，/サやデー 
タベ-スブ〇グラム〉がオー— レイフ7■イルやメッセージフ r イルを検索するデイ 
レクトリのまた、コンパイラ、アセンブラ、リンカがそのソースファイルやワー 

キングファイルを見つけるディ レクト リの指定などがあります。 

APPEND が役に立たず、Vましくない効*を{む可能性がある代 S 的な場合としては 
7-ドプロセッサでファイルをする BS に、 te!t されたファイルは（例え APPEND 
か镛 fp ■嶠 irr 亀■たぶん fLa ; *rf ■ |Tnp m た 

ります。これはワードブロセッサが以下のような ifcfr: をしているからです。 

APPEND で；*: i したディレクトリとカレン!•ディレクトリは3?なっていて、 APPEND 
で及定したディレクトリにあるフ7•イル（•■元のファイル j> を蝙粜する場合、 

(1) 「元のフ T イル j のみ込む。 

(2) * レンI■ディレクトにの？；«の出カフ T イルを作る- 
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(3) 〇亡のファイル j を削除しよっとしたが、々レントディレクトリに•■元のファイ 
ル j はないので削除でない （APPEND で»定したディレクトリに「元のファイ 
ル j は找っている h 

(4) (2) のフ t イルを「元のファイル j 名にリネームする,， 

となるので、「无のファイル j が append て -sta: したデイレクト y と、カレントディ 
レクトリに2っで§てしまいます《 

• PROGRAM と PARAMETERS 

これらの特殊な贝埤変数は外部コマンドが尖行されるときに COMMAND2.COM に 
よって汶定され、終了するときに W 除されます0したがって、の目的で使川する 
ことは)8けなければなりません， 

• TEMP 

パイプが吏行されると （6* I■リダイレクシ B ンとパイプ J を参照)、 COMMAND2.COM 
はひとっ以上のテンボラりファイルを作成;します。 TEMP 51境変数はこれらのテンポ 
ラリファイルが作戌されるドライブとディレクトリを >7；•します • デフォルトでは，ブー 
卜 ドライプのルートディレクトりが报定されていますが、一般的にはスピードを向上 
させるため RAM ディスクを多照するように* E します。 

の MSX DOS システムはパイプのためだけに TEMP を使印していますが，テ 
ンポラリファイルをイ械する必要のある他のブログラムやユーティリチィも TEMP® 
境*数を使用することができます。 

• UPPER 

これは外部コマンドに渡す008 Oh 番地からのコマンド行を大文字に*換するかどうか 
を制御します。 r ONj (小文字も可）以外のすべての値は 「OFFj として解釈されます。 
UPPER が飞) FFj (デフォルト）の場任，コマンド行は何の*換も17われず，タイプ 
したままのが外部コマンドに漉されます0 

UPPER が 「 ONj の場合コマン P 行の文卞はそれぞれ対応する大文字に変換され、外 
部コマンドに典されます。これは CP/M の设境と互換性があります。 

• REDIR 

これは3マンド行中のリダイレクン3ンやバイフ•文卞を COMMAND2.COM で®:輝す 
るかどっかを制御します。 r 0FFj 《小文字も可}以外のすべての tt は r 0Nj として解 
択されます。 

REDIR が r OFFj の极合リダイレクシヨンやパイブ文字はそのまま外部コマントに她 
され、外部コマンドて •«!:« ができるようにします。 

REDIR が r ONj <デフォルト）の場 ft、 リダイレクシヨンやハ•イブは COMMAND2.COM 
が《釈、其行するため、外部コマンドに渡されません • 
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• EXPERT ( ^-3〇1 ) 

EXPERT は DOS I で 7 ォー マツ トされたディスク上のプログラムを实行させるかさせ 
ないかを制御します。これは MSX DOS のパージ3ンの遑いからくる問題を未然に防 
ぐために逬加しました， r ONj (小文字も" T) 以外の»はすべて r OFFj として解釈し 
ます。 EXPERT が存在しない（デフォル！ •> か r OFFj の場合は DOS1 でフォー マゾ 
卜されたディスクからのブログラムの哭行は SIjI •されます。この場合、次のよ1なブ 
ロンブ！•が出力されます。 



EXPER:1’ が r ONj の鳩合は D0S1 でフォーマットされたディスクからのブログラム 
の実行が可能になります • 


8.2 MSX DOS version 2.31 の新機能 

谓境変»がコマンド行に取 1 )込めるようになりました， 

55境変 S 名はファイル*などと区するため、前後に％をつけます。 
例えば、以 T のようにすると琛境変 5RKHELP の内容を表示します， 
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35 8 * 現境 4 ■数の; S: 定 


8.3 環境変数の初期値一覧 

设境変数は、 U 下のように初期设定されます。 


表 2.4 圾境変 ft の初朗姐 


取境変数名 

初期値 

APPEND 

なし 

DATE 

yy-mm dd 

ECHO 

OFF 

EXPERT 

なし 

HELP 

A:¥HELP 

KHELP 

A:¥KHELP 

PATH 

PROGRAM と PARAMETERS 

なし 

PROMPT 

OFF 

REDIR 

ON 

SHELL 

COMMAN 匿 C 籲 M が口ードされたところ 

TEMP 

A:¥ 

TIME 

12 

UPPER 

OFF 



エラー および メッセージ 


9.1 ディスクエラー 

ディスクエラーは例えばディスクがドライプ中に人っていない塲会のように、コマンドま 
た (i ブログラムがディスタにアクセスしようとし、何らかの®因で失敗した場合に起こりま 
す。エラーが発生すると、メッセージとブロンブトが去示され^ (例えばディスクを正しくド 
ライプにセットしたことなどによって）热理を再実行する、热®を無栊する、あるいはコマ 
ンド全体を中 ik するという进択がユーザーに与えられます。 

ディスクエラーのメッセージとプロンプトの例は以下のようなもので、卜•ライブ A がアク 
セスされている間にディスクが取り出？れた場合に表示されます。 


Abort, Retry or Igaor* (*/R/I>? 


f ~ 

I ディスクが入っていません（狡み込み中）I••ライプ UA: 
■I'Jl «>/冉 R 行〇〇/第拢（1)? 


hSd の例で r.Notreadyj •■ディスクが入っていません」の部分はディスクの搡作が失敗した 
理由を示し、状況(亡よりX的メッセージ（下纪参照）ヒなります„ r rea rtingj 「(読み込み中) j 
はコマンドがディスクを决み込み屮の場合で、卉き込み中の場合には Wingj 「(誉き込み 
中) J に代わります。 r drive A：j ••ドライブは A :J はアクセスしようとして“たドライブ名 
です。 

r Abort,Rfitryorlgnore (A/R/I)?J 「屮止 （A)/ 再试行 （R)/ 無視 （I)?j の部分はユーザー 
が行う ことのできる助作を示し、 これらは IRJ. あるいは0キーを押すことによっ 


Retry (冉:式む）を®択すると失敗したディスク操作がそのまま冉実行されます。その前 
に、入っていなかったディスクを揷人するなどといったなんらかの抑作が取られた場合には， 
趄理は正常に行なわれます • 

Ignore (無祝）を通択すると、失敗したディスク描作か無视されます。多くの場 ft, エラー 
を無視するのは甲ま しいことではないので、その時には！ gnore オブションは角而には表ポさ 
れませんが、迸択することは可能です。 

エラーを無視すると、 t 大なンステムエラーを引き起こし、ディスク上のデータか破壊さ 
れることがあ9ます。 Ignore ォブン3ンが表示されたとしても、他のすべての操作が失敗し 
た場 ft にのみ怕*に fit 用して下さい。 

通常、ディスク上のデータに陣方が発生し、ディスクエラーを無現することがデータの全 
部あるいは一部を復话する咁一の可陡件である場合•にのみ Ignore を使用します。 

S 大なエラ • （ディスクが使用不 "J 能なくらい tK 傷しているなど）が発生した劣合、処理 
Ufl 動的に中 Jt 3れ、通、 1 i なエ，ーメ ./ セージが表示されます （ r Ba ( lfile allocationtablej 
「FAT 3?常てす j など >• 

ディスクエラーとして起こり得るエラーとその总味を U ドに示します 0 なお、内は， 
スクリーンモードが淇字モードに»定 S れている場合に出力される H 本；:5メッセージです。 

表 2.5 ディスクエラーー n 


英《» エラーメ v セージ_ n 本 J エラ-メ/セ--ジ_ 

Bad Hie allocation table FAT 異常です 

テ•ィスクのファイルアロケ—•ン 3 ンテ—ブル (FAT) が異常です。 

FAT と {i、 それぞれのファイルのデータがディスク上のどこにあるのかを知 
らせる ffi 相をンステムが®持するためのディスク上の«域です。したがって FAT 
の内容がIしくないと、すべてのデータがまったく瑰めなくなります。このメヴ 
セージは通 K、 ディスクが使用できないくらいす負傷してV、ることを意1味します • 

Cannot format this drive このドライプはフオーマットできま甘ん 

ディスクのフォーマッティングをサポートしていないドライプ中のディスクを 
7オーマットしようとしました，これは、 RAM ディスクを指定して FORMAT 
コマンドを文行した場合などに発生します。 


Data error ディスクのデータが異常です 

データがエラーなして -5* まれた、あるいは蚤き込まれたが、 CRC チ*ックで 
データのエラーが先見されました，これは通常、ディスクの陣害を意味します • 


Disk error ディスクが異常です 

データがディスクに対して说み書きできませんでした， 



B 本語エラーメ 7 セージ 

このディスクは使用できません 



共痛エラー//セージ {エラー 〆 K セージ 

Wrong disk ディスクが違います 

Wrong disk for file このファイル用のディスク T はありませ 

ん 

MSX DOS が1改ディスクにアクセスし、その後もつ 1ISR じディスクにア 
クセスする必要が生じましが、I••ライプに J {なったディスクが入っていました， 
止しいデ■(スタを入れて、 「Retryj を进択します。 


9.2 コマンドエラー 

コマンドエラーはコマンドの嫌能を何らかの*由で其行できない祕 fl •に起こります。 
エラーがコマンド中で起こリ、継綾できないような場合には.迪当なエラーメッセージが 
出力されます。 

エラーメッセージは例えば;欠のように衣示されます， 



3つのアスタリスク「***」が: te 初に表示されてエラーが起こったことを示します。次にメ y 
セージが出力され《次の行に通*のコマンドブロンブトが tt きます • e こり得るすべてのエ 
ラーは後述します c 

9.2.1 エラータイプ付きのエラ-メッセージ 

コマンドのエラーか1$定の状況で起こると、「エラータイプ j メッセージも出力されるこ 
とがあります。例えば，通*必要な77■イルがディスク上で兒つからないと、上纪の例のよ 
うに， r File not foundj r 7 7•イルが見つかりません j メリセ_ジが出力されます。 

必3?な 7T イルがリダイレクシ3ン K 号 1 ■ぐ| (6¢「リダイレクン 3 ンとパイプ j を参 W) 
によって指丈されていると、出力されるメッセージは次のようになI)ます。 
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起こり得るエラータイプを以ドにボします。 

表2. 6 エラータイプー钛 


s„a エラーメッセージ 11 本迸エラーメ ./ セージ 

Batch file error ： パツチファイル 1 5 — : 

パッチフ7■イルから読もう t している間に起こったエラーです。 

例えぱ、ディスクエラーが®こって r abortj が選択されたときに出力され 
ます。 

Piplngerror: パイプ ; C ラー： 

バイプ理中に起こったエラーで、多くの場合は COMMAND2.COM か(1=-成 
するテンポラリフ r イルとの两违で起こります <6货 1 ■リダイレクン3ンとパイ 
ブ J を参照)。 

f« えば、 TEMP S3 境変数（8¢「5!境変 ft の aaj を!?照）が 1T しいドライ 
ブやディレクトリを备照していないときに出力されます。 


Redirection error: リダイレクトエ，一 i 

リダイレクト趔理屮に起こったエラーです。 

例えば，リダイレクシ a ン 2C 冷 r <j, r >j ' あるいは r »j (6¢ •■リダイ 
レクン3ン t パイブ J を#.明）の後にイ、正なファイル名が捎定されている，ある 
いは衍定の入カフ T イルが見つからないときに出力されます。 

» r ■レクシ■ヨンあるいは /■f イブがセ7トアップされた後に.コマンドまた 
はプログラムへの®準人力で起こったエラーです。 

例えば、フ7•イルから 8T 奉入力がリダイレクトされているが、エンドオプ7 ア 
イルに速したと Si:m 力されます， 


Standardoutput error: 標準出カエラー： 

>) ダイレク•〆 a ンあるいはノ <イブ**セットアップされた後にコマンドまたは 
ブ〇グラムからの樣準出力で起こったエラーです • 

例えば棵準出力がファイルヘリダイレクトされているが、ディスクが一杯の 
ときに出力されます。 
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9.2.2 ファイル名付きのエラーメッセージ 


多くのコマンドは扭数の7 T イルやディレクトリを Jft 作し、ワイルドカードでファイル 
名を9えるとコマンドはいくつものファイルあるい U ディレクトリを) St 理します（例えば 
RENAME コマンドや COPY コマンドなど〉。コマ/ドを笑行していると S に，あるファイ 
ルてエラーか起こったが，別のフ t イルでは I* 功すると思われる場合があります（例えば 
1 ■琥み出し*用 j にセットせれている場合)。その場合には、フ r イル名が表ホされ、その後 
にエラーメッセ_ジか ili 力されてコマンドは樾较します • 

これは例えば次のようになリます。 


COKXAH02.CQH H Fils cannot ba copied onto itself 


COMHAMD2.COM - fl 分 '6 分には 3 ビーできません 


9.2.3 エラーメッセージ 
以下にアルファべット m で，起こ 1 )得るエラーを示します。 

表2_7エラーメッセージー K 

共 JS エラーメッセージ B 本 JS エラーメッセージ 

Cannot concatenate destination 後写先ファイルは tt 合で#ません 
file 

このエラーは CONCAT で起こリ、ソースフ7•イルの指定に*合するフ7•イ 
ル名のひとつが B 的ファイルであることを$味します。 

これは必ずしも淇〇ではないのですが，コマンド中での指定 R りの可能性を 


Cannot create destination file フアイルを作成できません 

これは COPY によって起こるエラーで、通常コビーしようとしているファイ 
ルの B 的フ t イルがもし作成されたとすると，すでに使用中のフ r イルを重ね S 
きしてしまうことを S 味します。 

これはソースフ t イルまたは、現在突行中のパッチファイルのような使用巾 
のフ7•イルにコビーしようとした場合に起こ 1 )ます。 



Ctrl-C pressed Ctrl-C が押されました 

1221^ + © が押されて 3 マンドが中断されました， 
Ctrl-STOP pressed Ctrl-STOP が押されました 

[CTRL； + [STOP! が押されてコマンドが中あされました， 



Oi-k full ディスクがいっぱいです 

ディスク1-.にう空き領域があリませんでした。この場合、コマンドを斯 
するためにはイ、要なフ T イルを削除しなければな0ません。 


Disk operation aborted ディスク入出力が打ち切*?れました 

ディスクエラーか起こリ、 「Aliortj オプン3ンが道ばれたため，コマンド令 
体を中断します。 


Duplicatefilenamc 7ァイル名が重®しています 

新しいファイル名が既存のフ r イル名と ISI —であるため、 RENAME (REK) 
または RNDIH が名劭の変®を支•行できませんでした。 

これはまた，移#力されるファイルやディレクトリと同じ名蘭のファイル名が 
fcj 的のデイレクトり中に存务する場合に、 MOVE や MVDIR でも発生します。 


End offile 


フ7イルの終わりです 


これは M 常コマンドでは起こりません。 


Environment string too long 環墳変数が ft 過ぎます 

これは通常コマンドでは«こりません。 

Error on standard input 樣単入力でエラーが起きました 

これは通常コマンドからは起こらず、コマンドがキーボードから政み込まれ 
ようとしている間にエラーが起こったことを示します。 


Error on standard output 樣準出力て•エラ-が起きました 

これは通常コマンドからは起こらず，コマンドが fflifli に#き込もうとしてい 

る閬にエラーが起こったことを示します。 

FUe access violation ファイルアクセス異常です 

これは通常コマンドでは起こりません， 

File allocation error 7アイルの SI 当異常です 

これは通常：7マンドで a 起こりません， 

File cannot be copied onto itself 自分自身にはコビーで#ません 

-ス77■イルを |nj じ 7T イルに：*ビーしよう t しました • 


Fileexists フアイ ルが BUZ あります 

MKD1R (MD) で新しいディレクトりを作成しようとしたが，指定のデイレ 
クトリ屮に岡じ名葫のファイルが存在しました。 



共 iS エラー〆/セージ II本 S5X ラーメ 7セー 〆 

File for HELP not foiiiul HKI . l * 7 アイルが見つかりません 






箔9¢エラーおよぴメ '■/セーシ 


致 -s エラ-メ /t-y n 本威エラーメ /セージ 

Invalid drive 無効なドライプ名て•す 

しないドライプが指定されました。 

Invalid environment string 無効な琢境变数です 

13境«数の名 m に不正な文字があります。 

ファイル名に使用で S る文字のみが、玟境変数の？;前に使用で S ます。 
Invalidfile handle 無効なファイルハンドルです 

これは; ifiSt コマンドでは起こリません。 


Invalid filename 不正なフアイル名です 

7 r イル？!に不止な文すがあリます。 

これはファイル名を衍定、もしくはワイルドカードを使ってファイル名を変 
K しようとしたときに起こ*)ます， 


Invalid number 無! U な数値です 

コマンド中に指定された fttt に欧字以外の文字があリます。 

Invalid option 無効なオプシ a ン播定です 

コマンドむ_で/の f 金に不 iT な文字が指定されました0 
Invalid . or .. operation .や..に対しては操作できません 

コマンドはディレクトリの ft 初にある 「_j と！の特味なデイレクトリに 
対して、その樯能を实行することはできません。 

Invalid parameter 無効なパラメータてす 

コマント•に対するパラメータか、そのコマン!■•に対してはおしくありません。 

Invalid pathname 無効なパス名です 

コマンド行で指定されたハ•ス名が#在しない、あるいは文法的な热りがあり 
ます。 


Invalid process id 無効なプ D セス ID て•す 

これは通常コマンドではこ9ません， 


Invalidtime 無効な時間です 

TIME コマンドで入力された時刻が正しぃ値ではなぃ、あるぃは不正な形式 
で人力されました* 

Miss^ngparameter パラメータが不足 L ています 

コマンドが必要とするパラメータ数より、ユーザー指定したパラメータの数 
か少なぃです • 

No spare file handles ファイルハンドルが足りません 

これは通常コマンドでは起こりません。 
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炎 a エラー/ /セージ H 本 JS エラーメ /セージ 

指定のコマンドで利用できるだけの十分なメモリがあリません， 

例えば、メモ”に人リきらないくらい大きいブ〇グラムを Sft み込もうとした、 
«し現境文字列のための十分なメモリがない、などが原因として考えられます。 
Not enough memory, system メモリが足りません.システムは停止 L 
halted ました 

MSX-UOS が起抑して、を技行•するのに卜分なメモリがないことが分かっ 
た 《fi 合■に出力3れる特珠なエラーメッセージです。 

メッセージが,;すように-〆ステムが給止したので、 a ンビユ ー タをリセント 
しなければなりません，これは通 {R は起こリません。 

Pathname too long パス名が長®ぎます 

パス名が技すぎます。 

指定のパス名の MS が100文字を超えているか、あるいはルートデ< レクト 
りからフ7■イルまでのパスの我3の介：«■が*3文卞を超えています。 

RAM disk already exists RAM DISK( I ••ライプ H:} は R にあ U 

ます 

これは通常コマンドでは起こりません0 
RAM disk does not exist RAM DISK がありません 

RAMDKK 3 マンドを使 Ml して RAM ディスクの••の AS さを表示しよう 
としたが、 RAM ディスクが存在しません* 

Read only file 7ァイルが嫌み出し専用です 

読出し卑用のフ T イルを突史あるいは重ね3きしようとしました， 

DIR コマンドによってこれを S 示することができ、 ATTRIB コマンI••でそれ 
を atm し専用でなくすることができます。 

Root directory full ルートヂィレクトリがいつぱいです 

ルートディレクトリ中のファイル数が決められた*人値（通常112)に遠し 
ています- 

サブディレクトリにはこの制限がありません， 

System flle exists システムファイルが RE にあります 

作成すると.システムフ t イルの®性を t.J っているファイルに$ね.? TS して 
しまうようなフ T イルを作成しようとしました. 

システムフ r イルは MSX DOS では使用されず、 DIR コマンドで表示されま 
せん。また、他のいかなるコマンドからもアクセスできないため、通常はこのエ 
ラーはコマンI••では起こ U ません， 
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第 9 窣エラーおよぴメッセージ 


泛忐エラー〆/セージ H 本适エラーメ/セージ 

Toomaoy parameters パラメ ー タが多すぎます 

3マンドが必要とするバラメータの R より、ユーザーの栴定したハ•ラメータ 
の数か多ぃです。 

指定のコマンI••は内部コマンドでなく、 PATH コマンドで a£ された現在の 
検索パスにある COM あるぃは BAT の外部コマンドでもありません。 

Wrong version of command コマンドのパ—ジ 3 ンが違います 

ブログラム•夫:行後、 COMMAND2.COM はデ< Xク上の COMMAND2.COM 

7アイルから d 分 H 身を再口ート•しようとしたが，それが Ml： バージ9ンで (i あ 
') ませんでした。 

プ〇ンブトが衣示され、 COMMAND2.COM け抖ぴ自分6身を再口ードしよ 
うとします。 


Wrong version ofMSX-DOS, sys- MSX-DOS のバージ a ンが違います 
tem halted システムは停止しました 

MSX-DOS が«抑しようとして、 MSX-DOS システムの W の部分が必要なも 
のより6以辟のパージ3ン»号を持つことが分かった場合に表示される特珠なェ 
ラーメッセージです • 

メッセージが示すようにシステムが停止したので、3ンピュータをりセット 
しなければなリません，これは通*は起こりません。 


内部的には、エラーはエラ_签号によって表現されています。そのためのメ7セージがな 
いエラー*5；-が受け取られるとその?5号が表ポされます。64以上の番号 UMSX DOS の栺 
术のパージ！》ンのために確保されており、 f •ン x テムエラと呼ばれます， 63tt 下の番せは 
外部のアブリケーションブログラムで使用することができ、>■ユーザエラ ーj と呼ばれます。 
32以下のユーザエラーはメッセージを表示しません0デフォルトのエラーメ y セージ（これ 
らは通常はコマンドでは起きない）は次のようにな 1 )ます。 

System error 64 •■システムエラー 64j 

および 

User error 63 •■ユーザェラー咖 


ここで64と63はエラー番号の例です„エラー番号を使用する唯一のコマント•は EXIT 3 
マンドです。前述のメッセージに対する其探の*号のリストは16章「エラー j にあ9ます。 





9.3 ブ〇ンプトメ 7 セージ 
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9.3 プロンプトメッセージ 

デ< スクを神人するなどといった、システムが&理を統行する篇にユーザーの勒作か必要 
な状況かいくつかあります。また、谱在的に危険なコマンドでは処理を实行する前にブ〇ン 
ブトを出して確涊を待っ必要があります • そのような場介に衣示される®々のシステムプ〇 
ンプトを以下に示します。 


( \ 

卜•ライブ B: 上の全てのデー，は<«ムされます 
' 何かキ••を押して F? い. 

このブ〇ンブトは FORMAT コマンドで出力され、問逢ったディスクを R ってフマット 
する fe 険を滅らします。 FORMAT コマンドを中止するには、 (CTRL1 + ISTOPI または 
rCTRL| + |Ci を押します • 












Eraso all files ( Y / ll )» 


I 全てのフ 7 •イルを W 去しますか （ Y / N )?_ 


DEL (または EltA、ERASE) 3マント-をディレクトリ中のすべてのファイルを指定して突 
行したと S にこのプ〇ンブトが出力され、多くの7 1 ?•イルを JR って削除してしまう fe 晚を少 
なくします， 


c - 

I a»«AMD2.C0H の人ったデ■(スク6ドライブ▲:に人れ て 下さい 
I W か キーを#して！ 'S い. 


これはブログラムを实行し終わった後に«こる場合があり、ルートディレクトリに COM 
MAND2.COM を-;'?むディスクが指 i のドライプに frtt する必要があります。 

ドライブ <MSX DOS が*初にブートされたドライブ）にディスクを挿人後、キーを押す 
と校行します， COMMAND2.COM が別な場所 (RAM ディスクなど）にコビーされている 
と，そこから COMMAND2.COM を冉ロードするように SHELL 歎をセットするこ 
とがで S ます （8 京変数の；9：定 j を幸,明 >• 


Insert batch Ill* disk in drive *. 


バ》チフ T イルの人ったディスクを（■•ライプ▲:に入れてドさい 
W かキーを押して T さい. 


これはパッチファイルの突行中に起こる場合があり、システムが;欠のコ7ンドを/<ッチフ T 
イルから«む必要があるのにドライプに正しいディスクがないということを示します。 

指：®のドライブレ、•ソチフ T イルが最初に起れたドライブ）にディスクを神入してキー 
を押すと，パッチファイルの実行が止常に «ti ■します • 





何かキーを ff して！ *3 い. 



作を記述した坍のメ 7セージの後に出力されます。これはまた PAUSE コマント•によって出力 
されます。コマンドを中止するには、 ICTRLl + fSTOPI または f^TRLj + ICl を押します。 



10 章 

Disk BASIC version 2.0 


システムち上け時に _ - 8 ■ | _ (MSXDOS2.SYS および COMMAND2.COM を 

金む）が存在しなかったり、 MSX-DOS の BASIC コマンドを15行した場 JK Disk BASIC 
version 2.0 が立ち上が9ます。 

Disk BASIC version 2.0 は光来の Disk BASIC version 1.0 を拡張したもので、 MSX-DOS2 
に対応するため， RAM ディスクと栢梅ディレクトリの操作命令，日本扭热埋のための命令 
が追加、あるいは挞張されています。 n 本语処塊間係の命令に ra しては U 章を参照して下 
さい. 

10.1 この章の表記法 

この章では、以下の表記法を用いまず。 

XJT - トメント % _ 

[棰能丨 命令の内容を簡取に31明しています。 

f 方式]命令の苜き方を示します。<> で囲まれた項自は、必要とする数値や文字の 
データを示します。|]で囲まれた項目は、省略可能であることを示します。 
[文例]实探に命令を使った例をあげています。 

[ «? at I その命令についての詳しい说明と.使用するときの注意などを述べてい 

ます。 


CALL CHDIR 


1 梭 能 

式丨 

カレントディレクト a を変«します。 

CALL CHDIR (，.[出1くパス〉"） 

i 文例1 

| CALL CHDIR (” DIR1-) 


1解说1 

CALL 

拽电は MSX . DOS の CHD 1 R と同じです， P .79 の 「 CHDIRj を#照し 
て下さい， 

CHDRV 

檐能' 

デフォルトドライブを切り挟えます。 

| 并式 | 

CALL CHDRVfdf ) 

1文例1 

I CALL CHDRVCHt") 

、 ノ 

| 解说 | 

镘能は MSX - DOS のブロンブトでドライプ名を入力したときと問じです。 

CALL MKDIR 

I 梭能—! 

W しいサブデイレク ！• リを作成します。 

| 方式 

CALL MKDIR {”[ d : l くパス〉”） 

I 文例 j 

^ CAU. NCDIRCDIB2') 1 


[W a I 楂电は MSX - DOS の MKD1R と网じです， P.U5 の 1 'MKDIRj を参別 



CALL RMDIR 


[檐能：ひとつあるいは複数のサブディレクトリを削 B； します。 
I # 式： CALL RMDIR(”[d:I< パス >_，） 


厂文例 1 



W 説 ] 拽能は MSX UOS の RMDIR と間じです， P.133 の r RMDIRj を参照 
して下さい。 


CALL RAMDISK _ 

[檐舫| ram ディスクの大き5をあるいは*»に代入します。 

[ 1& 式] CALLRAMDISK([ttfit]，[ 変数名 |) 

ただし、数 Ml と！*:数*の両方を省咯することはできません。どちらかを指 
定して下さい。 


QUX RANDISK(32) 

CALL RANDISK(1000, A) 


[解脱」 変数名を指定すると， RAMDISK の! Sft がこの*欧に代入されます， 

檐能は MSX-DOS の RAMDISK と冏じです， P.125 の 「RAMDISKj を 
麥照して F さい， 


CALL SYSTEM _ 

I楼能 j MSX-DOS に制御を M します- 
| 嗇式1 CALLSYSTEM|(”<DOS のコマンド名 >")J 
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FILES 

[檐能丨 ディスク t のファイル名、デイレクトり名を表示します。 

[方式] HLESI""? ァイル名，’ II. し1 

丨夂例] I 

1 - 1 FILES.M..*. 

[解说 I 機能は MSX DOS の DIR と M じです〇 R96 の 「DIRj を麥.明して下3 
い • FILES ,L はフ T イルをロング7 ォー マットで表示します- 



i2.0 の追加エラーメッセージ 



11 章 

日本語処理 


1. BIOS を使用して文宇を入出力している Bt 存のプ〇グラム （MSX DOS を含む）なら 
変 SE なしに奥宇入出力可能です。 

2. テキスト阈面で文宇にそれぞれ色播定が可*!です。 

3. JIS 第二水準の漢字をサポートします。 

4. St プリンタへの漢字出力をサボートします。 

5. システムに佤想«未入カインターフェイス (MSX-JE) が存在しない場合も.単漢卞 
変携棰能によって漢字の入力が可能です。 

6. グラフィック画面に対し、 LOCATE 文、 PRINT 文などで，文字出力が可能です》 


11.1この章の表記法 

この章では、以下の sa 法を用います。 

ステートメント名 

[機 fiE ] 命令の内容を！®电に说明しています， 

[嗇式]命令の畜き方を示します。<> で囲まれた項 g は、必要とする数 ffi や文字の 
データを示します。|】で囲まれた項目は、省略可能であることを示します。 

[文 W ] 実》に命令を使った例をあげています。 

[解说丨 その命令についての詳しい说明と，使用するときの注意などを述べてい 

ます。 


11.2 MSX 漢字ドライパ拡張 BASIC ステートメント 

以ドでは MSX 漢卞ドライバの拡張 BASIC ステートメントについて说明します。 


CALL KANJI 



ANK モードでの WIDTH の to のまが*字テキストモー 
ドでの 'VIDTH になります • 

KANJU か KANJ13 

ANK モードでの WIDTH の«がそのまま*字テキスト 
モードでの WIDTH になI)ます • 

K モードで SCBEEN 1を使用していた場合。 

KAMJIU か KANJ12 

ANK モ-■ドでの WIDTH の値がそのまま浼宇テキスト 
モードでの WIDTH にな9ます。 

KANJtl か KANJI3 

ANK モードでの WIDTH の姐の f が茨字テキストモー 
ドでの WIDTH になリます。 



第 11« B 本 S 処理 


ただし、計»によって決まった WIDTH が26来满の時は26 
に»定されます。 

• 澳字グラフィックモード 

常に表示できる®大に K 定5れます， 

WIDTH による SCREEN モ垂ドの iM 択 

• KANJIO か KANJI2 

WIDTH か26~32の!^は256ドットモ —（< (VDP のモ-ド 
で S うと SCREEN 5> が、 33- 64 の時は512 I••ットモード 
(VDP のモート•で S うと SCREEN7) が进択されます。 

• KANJI1 か KANJ13 

WIDTH が26~40の時は256 I•へ:/トモード （VDP のモート- 
で2う と SCREEN 5> が. 41-80 の時 U512 ドットモード 
(VDP のモードで S うと SCREEN 7) が进択されます， 

漢字入力 

痪字ドライパは仮》»末人カインター7ェイスを持っ力_トリッジが存在する場 
合は、起肋時にこれをインストールします。 i* 裱入カモード jANK> と間榷人 
力そード（潢字）は. lCTRLl + 1 SPACE) もしくは fGRAPHl + [SELECT] \Z 
よって切 1 )換えられます。 feS 端未入カインターフェイスが存在しないときは 
单*宇変换拽能 （11.4 字変換棰能 j を窨照）が使爪できます • 



11.2 MSX 漢字卜•ライパ拡張 BASIC ステートメ ✓卜 
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CALL ANK 

[機能I 漢字ドライパを終了します。 
f S_ 式] CALL ANK 



[W Sii I ® 字ドライパを終了します•ただし、*卞ドライバ用 J こ確保したメモリ 

は明放されません， 


CALLAKCNV 

[«t ] 文字を❖角文字に変換します。 


CALL AKCNV(< 文字 S 歎〉，<文字列〉） 


[文例 I 



<文字列>中のすベての文字を全角文 5 r に*換して < 文字®款> に代人 
します《 


厂解 jft 1 
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第 iit □ 本语処 a 


CALL JIS 

[« ] 文字を 16 it 4 桁の JIS コ•••ドに*換します。 

[S- 式 I CALI, JIS(< 文字変数>，< 文卞列 >) 


<文字列>の玷初の2パイトを16進4桁の JIS コードに変換してく文 
字* ft> に代入します。 


CALL SJIS _ 

I檐鼴丨 文字を16遨4桁のシフト J1S3- ドに®換します， 

[~»~«~ ] CALL SJIS(< 文字突数〉，<文字列 >) 

I文例] 

[解说I く文字列:> の最初の2パイトを 16* 4桁のシフト 3- ドに変換し 

て < 文字*数>に代人します • 






CALL KACNV 





CALL KINSTR 


[檐挺] 文字列中から、指定した文字列を探します。 

CALL KIXSTR(< 数誠* tt>【, <数式>|，<文字? >M>, <文字 M 2>> 



[解说 ] < 文す列 i> の中からく文す•列2>を«し出し、 a つかれば«兒した位 

芮を、見つからなければ〇を<数値*款>に代:入します。<数式>は探し始 
める位 ss を文字 K を 1 ！ 1 .位として指定するもので a 略されると1とみなされ 
ます。 


CALL KLEN 


[機能] 文字列の総义字 a を;; te します。 

) CA1XKLEN(< 数値変*!{>，<文卞列 >[, <拽能 >1) 


CALL KLEN(A. ■■今 U ハ 〇イ天41 です •> : PBINT A 
CALL KLEH(A, ■■今 FI ハ良イ天氕です*, 1):PRI»T A 
CALL KL£N(A, •今 f] ハ良イ天気です"， 2):PM»T * 




[ » K ' 裱能が 0 < もしくは省略）の時は*:文字列〉の全体の fi さを、 1 の時は 

<文宇列>中の半角文字の fe さを、2の時は<文字列>中の全角文字の ftg 
を <sie 変数 >に代入します。 





11.2 MSX 漢字ドライハ•披 56BAS1C ステートメント 


CALL KMID _ 


[機能I 文字列中から、指定した文字列を取り出します。 



式 

CALLKhUD(< 文字* »>. < 文字 W>. <a 式 1>(,<ft 式 2>]) 


r x' 


I CALL KMID(*» ••今 U は B い天 K です"， 3, 3).PRINT A* j 

ド 



ir~ 

I <文字列 > 中の<数式 1>*H の文字から<数式2>文字分だけ抜きだし 

てく文宇変数>に代入します。<我式2>が省略された埃合は<数式 1>#B 
の文字から終わりまですベての文字が代人されます， 

CALL 

KNJ 


L 檐 

能 

| 指定した放字コードに相>4する*字を文字*数に代入します • 


LX 

式 

| CALL KN.1(< 文 1 *•财>，<文神>) 


CX 

例 

| CALL KJIJ(A$, ■3441 , ):PBIBT *» 

ド J 


区 

~iT~ 

<文字列>で格'定される4桁の浼字コ ーP に相当 t る85字1文字を<文 
字変数>に代人します。漢卞コードか800 0H 未消の時は JIS、 以上の B 射 i 
*〆フト JIS とみなされます。 





CALL KTYPE 


檐能丨 


文字のタイプ（半角なら 0. 令角なら1> を数値変数に代入します。 


L*_^J 

[文例] 


CALL KTYPE(< 数値変数>, <文字列>，<数式 >) 




30 FOR 1-1 TO L 
40 CALL KTYPE(T, AS. I):PHU(T T; 


[w a ] < 文卞湃 > 中の <a 式: >»u の文肀のタイプ（半角なら o、 全角なら i> 

を < 数値変数 > に代人します。 


CALL CLS _ 

[機能丨 画 M をクリアします。 
「方 K 1 CALLCLS 



[W yi I CALLKANJI ステートメント K より画面を®字テキストモードにした 

ときに、両两をクリアするために使 ra します。谟字モードでないときでも 
使用できます- 




CALL PALETTE 


[描能丨 * ラーパレットの t;j 期化または » 定を行ないます。 

「 & 式丨 CALL PALETTE | ( </<レット8?咢 >• <#蟫1& >. <«!«度>. <冴揮度 
>)1 



「解； it | CALLKANJI ステートメントにより両面を茁字テキストモードにした 

ときに、パレットを変®するために使用します。泷宇モ_ドでないときで 
も使用できます。 

パラメ—夕をすべて«略した場合は、パレットを初期状雄にします。 
パラメータが拊定された場办、<パレット«号>で指定されたパレ v 卜 
を <亦«度>、<««*>、<心嫌*>の色に役定します。なお、パレット 
番号や各»*を«略することはできません。 


WIDTH 


「檐能1 1むに衣不する文字数を; a 定します。 


[及式 j WIDTH <*ifSC> 

I 文例 ■ 1 (^T 


解 m | WIDTH ステートメントは澳•ゼモードの時には以下のように IW 乍します， 

• 浼字テキストモードの場合 
- KANJIO か KANJI2 の場合 

<桁敢>の柑定は 26-64 が冇効です。 

- KANJI1 か KANJI3 の場合 

<桁 R> の指定は 26- 80 が有»です- 
上式以外の ft が術定されると illegal function call) とな”ます。 

• 灌卞グラフィックモート•の坳合 

常に r Illcgal function callj となります。 



11.3 漢字モードでの注意点 

11.3.1 漢字グラフィックモードでの PRINT 文 

HIT グラフィックモードでは PRINT 文によって文字出力が B| •能になりました，ただしこ 
れを使用する際には以ドの注意が必要です。 


1. LOCATE 文で报定する々ーソルポジンヨンは、角文字単位です- 

2. 々ーソルポジンヨンを保持しているエリアは1つしかないので，アクティブページを変 
S しながら PRINT していくと他のページでの力ーソルポジシ3ンの杉親を受けます。 


3. インタレースモード （KANJI2、KANJI3) で文字出力をする瞭は、 SCREEN 文で 
EVEN . ODD のインタレースモ-■ド (SCREEN , ,, , ,3) に»定して、 SET PAGE 
文で表示ページを奇数べージに、アクチィブページを表示ページ ー Iに W しなければ 
な 1 )ません。 

11 3.2 SCREEN 文 

従來 SCREEN モードを変更しただけでは、スプライ（•表示*?止ビット (VDP レジスタ 
8) やインタレースモード （VDP レジスタ 9) は変化しませんでしたが、旗宇モードでは両 
方ともクリアされます 0 ただし後名に明しては、 SCREEN 文の第6パラメータを同時に指 
定した場合は、_£しく 定されます。 


11.4 


単漢字変換機能 



CALLKANJI を实行 U 漢字モー h-C-ICTRLl+fSPACEl も L<«l GRAPH] +1 SELECT I 
を押すことによって画面 & 下行が反転し、単漢字入カモードになります。この機能で、 ICTRLl 
+ ISPACEJ (あるいは rGR APHl + fSELEC Tl) はトグルスイッチになっており、再びこ 
のキーをおすことによって笮澳字入カモードが終•了します< 

11.4.3 単漢字の入力方法 
漢字の入力 

前記の方法で取澳字入カモードに移行すると、仮想的な25行 h に仮名 a 字変換ゥ■{ンド 
ゥが反転*示？れ，単*換が万能になります。 

ここで「澳字 J という文字を入力する場合を例に準げます。 

1. fSil^ + iSPACEl によって漢宇入カモードに入ります。豳面敁ド行が反松表示され 
ます。 

2. 「かな| 、もしくは |SHlFH + f ^ な 1(ローマ字モ_ド）を押して、「か j を入力します。 


ド化仮 wwa 传ぬ吋* 


(表示される文 T 数 li«r 大10文字，文字数は漢字モード、スクリーンモードによって 
»なります） 


のように、「か」で始まる漢字が*示されます。 

3. «いて•■ん j を入力すると 

,圪侃茜*刊_ 



r かん j で始まる滇字が表示されます • 

4. 変換ウィンドウ内のカーソルを t, P、 左、右または (1PACEI キーで移勣し S 的の 
r S8j に命わせて、IぜIキーで決定します。すると、画面に「澳 j が衣示され、犮換ウィ 
ンドウ内はクリアされます。 

5. 次に r し」、 『\ i を入力（ローマ字変換の場合は、直按 1 ■じ J を入力 >• 

6. 同様にカーソルを 1 ■字 j に合わせて@キーを押します ■> 



変換中の訂正は (¥scl キーを押すことで可能です。 lESCl キーを押すと変換ウインドウ 
内がクリアされ、说み入力の状想に戾ります。 


全«ひらがな 
全 ft カタ*ナ 

半角カタ*ナ 
全角紀校 

全《英《宇 
第二水準 S 字 


Iかな1ランブが点灯している状態で入力します。 

屮沒字入カモードで[かなI、 fCAPSl (CAPSLOCIO キー 
の W 方が点灯している状想で入力します， 

[CAPSl (CAPS LOCK) キーの两方か点灯している状想 
で人力します- 

単漢字入カモードで、|かな]ランプが点灯している状態で 
1 ■を j やを入力すると、変換ウィンドウに纪号が a 示 
されるので、亡ーソルを表示したい特殊文卞や紀号に合わせ 
て M キーを押します。 

単漢宇入カモードでランブが点灯していない状雄で 
入力します， 

システムに第二水明孩字 ROM がある場合は、 HMK 宇入力 
モードで、&、なIランプが点灯している状扭で•'ん j などを 
入力し，カーソルを衣示したい痪字に合わせて M キーを押 
します- 


その他 

• 人力された娩みが存在しないときは、もっとも近い統みの漢字が_»示されます。 


• B 的の茁字が 1 ■苷 *»|j どちらの K みで fi 錄されているかは、別表を参照して T さい， 


• 口-マ字*換榱能について li、MSX 本体のローマ字変換機能と同様です， 

• 変換ウインドウか開いているとき |CTRL】 キーを押しながら逢統して r 0~9. A~Fj 
のキーを4桁入力すると、それを JIS 3 —ドとして、その3— ドから始まる潢字を表 
示します。選択方法は上に同じです. 

11.5 漢字プリンタの取り扱い 

MSX-DOS では、澳 t を画面に出力できるだけでなく、漢卞ブリンタにも出力できます。 
出力可能なプリンタは MSXfiSHt の*字プリンタとそれに準拠するものです。 MSX-DOS で 
は视字をプリンタに出力する場合は、鴻字イン（(^£) ©) や澳字アウト （(^j H)) 
を必紫に応じて神入します。（漢字モード時） 
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MSX DOS2 上から*字を含んだ7ァイルをプリンタに出力したい場合•には次のようにし 
ます. 

COPY KNJFILE PRN 

また，ファイル名やディレクトリ名が漢 f を含んでいる時でも、リダイレクトを利用して 
デイレクトリをブリンタに®力することができます。 


DIR > PRN 

BASICS! 校では、 JXIST. LPRINT. LFILES コマント，によってプリンタへの漠 'f: 出力が 
て Si す。 


12 章 

外部ブログラムの環境 


本章は MSX-DOS の下で外部ブログラムが実行される現坡について説明しプ〇グラム 
のエントリや終了、メモリの使用法などについて K 述します。 

12.1 MSX - DOS からのエントリ 

外部プログラムが開始されるときの Z80 のレジスタの内容は未定義です， RAM の〇番地 
から始まる*初の256パイトは 12.3 r ページ0の使用法 j で说明されるような«々のパラ 
メ-夕と 3 ー ドでセットアップされています。 

外部プログラムが開始されるときに (iWO 込みはイネーブルで、一 fcW にはイネーブルの 
ままにしておかなければなりません， MSX-DOS のファンクシ a ンコールは外部ブログラム 
が別り込みを禁止している場合でも、割り込みを許可して戻ります • 

12.2 MSX - DOS へのリターン 

外部プログラムは«下の4つの方法で终了させる亊•ができます。 

1. 呼び出し時のスタックポインタでリターン 

2. 001 0H 番地へジャンプ 

3. MSX-DOS の 1 ■プ卩グラムの終了 j ファンクションコール （P.269 参照） 

4 l#»-DOS«0 1 ■エラー3— ドを返して終了 j ファンクシ B ンコール （P.320 参照） 

1番目の方法で行うと以下のようになります。 COMMAND2.COM (4. 外部ブログラムを 
TPA の始めである010 0H 番地から口ードし、スタックポインタを TPA の最後から数パイト 
下に改定し、010 0H 番地から実行します。このときスタックトップには000 0H がプッシュ5 
れています。スタックポインタをプログラム側で再設定しないでリターンすると、 MSX-DOS 
に戻れるのはこのためです。 


ブログラムは、その剌の範 W 外で発生したイベントによっても終丫することがあリます， 
イベントとは、例えば、 ICTRLl + fcl^lCTRLI+ISTOPI をキーボードから入力した埃 
命や r Abort (中介） /Retry (科试 ff) /Ignore (無視) j のディスクエラーメッセージに対 
する応答として「中止」をユーザーが迸択した場合、あるいは標準 I/O チャンネルてエラー 
が発生した場合などです。その場分、迪当な x ラー：!ー ドが MSX-DOS に返されます。 

外部ブログラムでは•■アボートルーチン j を定*することができます， 

これは 1 ■プログラムの終了 j あるいは r エラーコードを；&して終了 j 7T ンクン 3 ンによつ 
てブログラムが終了したとき、あるいは中止エラー （IJd 窬 •«» の後で3—ルされ、ブ〇グ 
ラムの異常終了を jE しく *1 理することができます。このルーチンの定«の仕方およびどの場 
命に坫用できるかについては 17.3 r 7r ンクシ s ンの说明 j で说明されています。 


12.3 ページ0の使用法 



12.3 ベージ〇の使 /H 法 
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プハイトを -d 访していますが， MSX DOS 坩のプログラムではこれを多照せずに、 1 '办レン 
トトライプ <^£ Wj のフアンクンヨン3— ルを tt 川し t F さい • 

10BYTE とユーザ- ffij-li I/O のりダイレクシ3ンが CP/M と |iij 一の A •法では行われて 
おらす、 MSX-DOS にユーザー番 y- の疑念は存在しないためサポートされていません， 
•00511番地には MSX DOS コールを実 H するために使 IH される MSX-DOS の常8部分の 
ISJWiS 地へのジャンプ命令があります，このジャンブのアドレス Uf«l 睁にプ〇グラムが策用 
できる' HW の h 限+1を表します。 g い換えると，ブ〇グラムか使用で S るのは010 0H 推地 
J ら，0««^»地と00071^番地で示される»地マイナス1までです。 TPA のサイズ (i ディス 
クインターフェイス亡ートリッジの税姑べ^によって兴なりますが、 -H» 的には約 53K です， 


この•ンャンプの-ンャンプ先の下位パイトは CP/M との換11のため常に0611で、 CP/M 
では. その也曲の8パイ（•が CP/M のパー•ン s ン S 号と•✓リアル振Vを保持しています。 

••0811-002811までの Z80 のりスタート fir 令の璣ぴ; U4、 ユーザー坩にそれぞれ*•パイト 
が f •約されていて、そこにジャンプ命令を逋くことができます-ただし、リスタートの»の 
衿々..1パイトは MSX ス〇ット切リ换えルーチンへのエントリポイントとして«;用されます， 

«(W«I~005BH までの令故城は、 MSX の*IIリ込みとスロット切り換え3 —卜•のため 
に使用されますので、ここを变圯してはいけません，大部分の CP/M のデバッガ （ZSID や 
DDT など > は3811番埯をプレークポイントエントリとして使していますので、これらの 
ブログラムは«なったリスタートを使坩するように，«!£しなければなりません， RST28H 
を使うことを推獎します。 

005 CI [番地と006 CH# 地に_设定されている2つの FCBU、 コマンド行の进初の2つのパ 
ラメータを 7T イル名として解«した有効なオープンされていない FCB です。どちらのフ r 
イル名も使用する場合、2番 B のものは最初のものが才-'プンされると 4Ua-,»TS されてしま 
うため、メモリ中の利な堪所の FCB へ:3ピーしなければなりません。 FCB の7ォーマ7卜 
については 13.5 r 7T イル3ントロールプ d ツク （FCB)j を参照して下さい， 

コマンド行全体 （W 切のコマンドを除いたもの）は0080 H» 地のデフォルトのディスク fe 
送®城にストアされます。 ii 初の1パイトには渡された文字数が人っており、 W 後にヌルが付 
加されます（ヌルと长さのパイ！•は、长さには岔まれません h この文卞列は CP/M との弁換 
仕を確保するため、細にいくっ空白文字が入力されていてもそれを含みます。 MSX DOS1 
との S: 換性を確保するため通常、文卞 WU そのまま（大文字に突換されずに）ストアされま 
すが、 CP/M との件を®视して®境®数 UPPER (8 令多を ON に议定しておくと 
大文卞に®換されます。 

MSX DOS 用の新しいプ〇グラムは CP/M の PCB を使用すべきではありません。なぜな 
ら，よリ使うのが®举な MSX-DOS コールが HJS されていて、それを使えばディレクト U 
をアクセスしたりパス？；の达理を打ったりすることができるからです（これらの檐能につい 
ての洋柚<よ17.3 r 77•ンクシヨンの;) WUj を #M). 

コマンド行にアクセスするのに、よ 1 )改迕された方法を使うこともできます。環境変数 
rpARAMETERSj には、コマン！ "Ir が大文字に变換されずに保 fV されています， SC の®境 
«» r RROGRAXIj によって、ブ〇グラム Ufl 分が〇— ドされたドライブ、ディレクトリ 



のアドレス(こは別のジャンブ命令があり、これは rr エントリあるジャンブテーブル中の2 S 
U のエントリです。これは CP/M 2.2 の BIOS ジャンプテーブルに完全に対応しています • 
テ--ブル中の ft 初の8つの x ントリ U リブートと文字人出ガのためにあります。これらの 



我 2.9 BIOS のジャンプベクタ中のエントリ 


12.5 RAM ページング 

外部ブログラムが D- ド$れたときには、4つのページすベてにマッパ ー RAM のスロ./ 
卜が«択5れ、基本の 64K を構成する4つの RAM セグメントがべージングされています。 
MSX BIOS ROM .8； 換のスロット JMS エントリボイントがべ'-ジ〇で利用でき、播々のマ y 
バーサポー!•ルーチンがべ“ジ3で利用できます（これ6の什様については15挛を参照)。 

ブログラムは戈:行中に任意にスロットの切り換えやべージングを行うことができます•も 
ちろんプログラムはページ0を変更する場合には•拥り込みおよびス〇ット切り換えのエント 
リボイント C ついて} J..3： をしなければならず、また艳対にページ3を*史してはいけません, 

MSX-DOS のフアンクシヨンコ_ルや MSX-DOS の BIOS フアンクシ3ンコールを実行 
する場泠、任*のス〇ットおよび RAM セグメントをページ0,1、および2に逝択でき、ま 
た、スタックも任 S のページ中におくことができます，現 A のページの状態はエラー状链て 
あっても.すべてのフアンクシ3ンコールで保存されます。任意のパラメータをその時遵択 
されているべージから*すことができますが、をディスク fcA だけはスロットの进 


^ ムス •/ タアタタ タ 
|トト 1 力力 tbA.t.-NWUDHAo^”o 
ス以 wliitititititititi'ti 

H-:mJJ;;:sss 

3■ 一 lr>'• パ > VXM-r/H/H/M/M/M/H/MtK/M 
1 ゥゥ 3 n コリパ ycpcpcpcpcpcpcp リ CP 

== h E i i = I = = _ 

一 ^ lJMPJMPJMPJMPJMPJHPJMPJHPJXPJMPJMPJMPJSPJHPJMPJMP 

ス 

KW00H03H06H09HOCHOFH2H15H18H1BH1EH1H24H27HAHS30R 
ァ xxxxxxuxxuxxxxu 3 xxlxxlXXIxxss 似 XX2 灯奴 
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択にかかわらず、ファンクシ3ンコールが尖行されるときにべージングされている RAM セ 
グメント（それらが元の TPA セグメントでなくて t> に対して実行されます。 

外部プログラムが TPA 以上の RAM を使用したい場 ft、 マ./パーサポートルーチン <15 
龟参照）を使用してそれ以上の RAM を摧得できます。4っの TPA セグメント以外の RAM 
を使 ffl する lB に.プログラムはマッパールーチンに新しいセグメントの割り付けを命じます。 
これによって，新たに RAM セグメントを使用しようとするプログラムと RAM ディスクな 
どですでに使用中のセグメントとの競合を避けることができます。 

セグメントはブログラムが終了すると 0IPJ に解放されるように、通常「ユーザーセグメ 
ント j として別り付けて下さい，し〆ステムセグメント j は、外81!ブ〇グラムが終了した後 
も使 ffl 中として残しておく必要がある場合•にのみ、割り付けます。 

迫加のセグメントを割り付ければ、ブログラムはそれをページングしたリ、マッパーサボー 
トルーチンを使用してアクセスしたりできます。通常、外部プ〇グラムは、必要な場合に再 
ぴ元のページに灰せるように、元の TPA セグメントのセグメント畨号をする必要があ 
ります。セグメントは通常0、1、2、および3ですが、これらの#号を使用しているもの 
と仮定して外部プログラムを作成してはな0ません。外部プログラムは必ず別のものをペー 
ジングする前に、 「 get - Piij マッパールーチンを使用してセグメント番 y- を知っておかなけ 
れぱなりません。 
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デイスクフアイルの構造 


13.1デバイスおよび文字 I/O 


ファイル名を MSX-DOS のファンクシ a ンに指定できる場合には、デバイス名も同じよ 
うに与えることができます。これらのデバイスは文字ベースの I/O で使用され.それによつ 
てブ d グラムはどちらを使 W しているか知る必要なく、ディスクフ t イルと文字デハ•イスを 
まった <同一の方法でアクセ乂で S るようにな 1 )ます。その塲合にどちらを使用しているか 
を知る必要はありません。 

デバイス名の P 文はファイル名の構文と岡一で，ブ〇グラムはデパイス名を扱う取に特別 
な処理.を必要としません。このことは新しい MSX-D0S2 ファンクシ*ンにも CP/M 互換の 
FCB ファンクシ*ンにも当てはまります。デパイスに使用されるため-了•約されているフ T イ 
ル名は次のとおりて•す。 


表 2.10 デバイス用了■約ファイル名 


デバイス名 S 味 
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用てきるように迪当なル—チンをフックすることができます。 

NUL デ/<イスは尤 IS には何もしません。出力文字は無視され-人力は常にエンドオブフ t 
イルとなリます。 

LST と PRN デバイスは M —です。 

CON テパイスはキーボードからの说み込み、あるいは画而への占き込みに使用します。 
aw テバイスから31み m す場 fK 1わ入力が行われ、ユーザーは行拽能を使用できま 
す-」ユーザーか CR (リターン）を柙すとはじめてその行が入力されます。入力の柊わりは 
行頭の ~z 文字で銥別されます。 

システムは f_i 肋的にいくつかのファイルハンドルをこれらの15*¢;デバイスに対して才ープ 
ンします （If 細については W.2 I■ファイルハンドル j を参照）。これらのファイルハンドル 
は、樣够デバイスをアクセスするためにブ〇グラムで使用できます。あるいは、プログラム 
は従米の CP/M の文字ファンクション（•7ァンクン9ン0111~0131«を使用して、文字 I/O 
を H ■うことができます。これらの2つの方法はどちらも許されますが、それぞれ別のバッファ 
リングのわ•法を使用しており、混用すると文宇!^パッファ中で失われてしまう吋能性があり 
ますので、通常はこれらを iE 用するべきではありません， 

コマンド行によリリダイレクシ3ンが行われると，岣方のアクセス方法（標<¢7ァイルハ 
ンドルと文字ファンクション）がりダイレクトされます。しかし、ディスクファイルをアク 
セスするときには、標！ f ファイルハンドルを使用して大きなプロックで»み卉きをする方が 
文字ファンクシ s ンを使用するよりもはるかに iBi 速ですのでこちらの方が望ましいでしょう。 

コマント*行による 1 )ダイレクシ a ンが h ■われている垛合にもブ〇グラムではりダイレクシ3 
ンをされていなぃ幽而出力とキーポード人力が必要になることがあります。例えば、ディス 
クエラー処理;レーチンではこれが必5?です。これを可能にするため，文字7ァンクンョンの 
リダイレクシ*ンを一時的にキャンセルするための77•ンクン a ンが提供されています • こ 
れは 17.3 •■ファンクシ s ンの说明 j に 2C 述されています （P.329 参•明)。 

13.2 ファイルハンドル 

斩しい MSX DOS のフ T ンクンョンコールを用いて 7T イルのアクセスを行なう場合 
7 7■イルハンドルを使用します。また、ファイルヘンドルは7ァイル®性の操作などの 7T 
イルの找作にも使用できます。 

7 7•イルハンI••ルは特定の才ープン7 7■イルやデバイスを窬照する8ビットの数 fjfl です。 
新しいファイルハンドルは•■ファイルハンドルのオープン j (P.295 参照）あるいは r 7 T ィ 
ルハンドルの77•ンクン s ン （P296 麥 S!!> により別割当てられます。77■イルハンド 
ルほファイルとのデータの SSA® きに使用され、 r 7T イルハンドルのクロース J (P.297 参 
や 1 ■ファイルハンドルの削除」ファンクション （P.309 参照）力<3-ル5れるまて存在し 
校けます，また、ファイルの属性を変吏したリ名前を®吏した9といった処理もファイルハ 
ン H •ルを使って実行することができます • 

MSX-DOS が新しいフ7■イルハンドルを割り当てるときにほ、使用できる最小の番号を使 
用します，現在のパージ a ンでの最大のファイルハンドルの番号は63です。将来のパージョ 



変数もします。 

外部ブ〇グラムが无行される BK には、各播のフ T イルハンドルが拥もって定袭され、才一 
プンされています，これらのファイルハンドルは揉中入出カデパイスを费照しています (13.1 
1 ■デバイスおよび文字 I/ Oj を参.！!8>。「旧米の J CP/M スタイルの MSX-DOS 文 TI ゾ〇フ T 
ンクシ3ンは灾瞄にはこれらのフ7•イルハンドルを参照します。 

外部ブログラムは、37ンドインタープり夕が te 用していた人出力のファイルハンド 
ルではなく>其際にはそのコビーを* W します。つまりブログラムは、これらのフ7•イル ハ 
ンドルを0山にクローズしたり、別のファイルハンドルをオープンしたりでき、またこれ 
らのファイルハンドルをブログラム終了の阑に元に埃したリする必要があリません。デフォ 
ルトのフ t イルハンI••ルとその行先を次に示します。 


我2 .11デフオルトのファイルハンドル 
フ t イルハンドル Sn 衣 

〇 «亦人力 (CON) 

1 橡準出力 (CON) 

2 橡準エラー入出力 （CON) 

3 «[取補助入出力 (AUX) 

4 橡準プリンタ出力 (PRN) 


コマンドインターブリタは外 a プログラムなどのコマント•を文行する前に，•■子ブ〇セス 
の起 £l)j ファンクシ s ン （P.318 参照）を其行します。この7アンク'〆 s ンコールはンステム 
に対して，新しいプログラムが「サプルーチン j として実行されようとしていることを报尜 
します。そして、現在才ーブンされているファイルハンドルがすべてコビーされて、新しい 
ブログラムはコ7ンドインターブり夕のハンドルではなく、もとのハンドルのコビーを使用 
することになります。 

外 SB ブログラムが味存のフ T イルハンドルをクローズしたり、新しいものをオ_プンする 
ことによって、なんらかのファイルハンドルを変更した塌合には、それはブログラム自#の 
ファイルハンドルのセットが変IIされたことになり、もとのセ"/卜«変史されずに残ります 
ブログラムが終了したあと、コ7ント•インタープリタは「親ブロセスに戻る j フアンクシ 3 
ンコール (P.3l8$ffi) を実行し、それに W 初のブロセスの起動 J から返されたプロセス 
ID を®します。これによって新しいブ D グラムが終/•したことが-〆ステムに報告され、その 



プログラムで使用されていたすベてのファイルハンドルを捨てることができます。 

それそれのフ7•イルハンドルについて、いくつコビーが存在するかという参,照カウントが 
保#されているので、システムはブ〇グラムが終了.したときに必要のなくなったファイルハ 
ンドルを枝现することができます。これによって、きちんと作られていないプログラムがファ 
イルハンドルをクローズしなかったためにシステムがファイルハンドルを使いつくしてしま 
うよつな-#態を防ぎます。 

これらの r 子プロセスの起動 j と r 親ブロセスに戾る j 7 t •ンクンョン Ji もし有用であれ 
ぱユーザーブログラムで使用することができます，•■親ブロセスに R る j ファンクシ3ン U 
ファイルハンドルを整理し、ブログラムが解放しなかったすべてのユーザー剌リ典て RAM 
セグメントを解放します。 

13.3 ディスク上のデータ構造 

ファイルやサブディレクトりは、ファンクションコールを使用すれば，手轻にキメ細か< 
取り扱うことができます。ユーザーは、ディスク上でファイルやサブディレクトリがどのよ 
うな方法で管《され、どのような形式で記》されているか、といった情報を «r しく知る必要 
li ありません。しかし、場合によっては、ディスクの苷情報を取り出したり、それをもと 
にフ T イルやサブディレクトリと li 無問係にディスクを««アクセスしたりする手段が必要 
になることがあります。 

MSX--D0S2 では、このような□的のために、ディスクの報をたり、「綸®セクタ j 
を iff 接アクセスするファンクションコールを用意しています。 

セクタを A 接アクセスする場合には、どのセクタにどういった ffl 供が? T き込まれてI、るか、 
という桩本知通が必要になります。 


13.3.1 論理セクタ 

MSX D^S2 では、 3.5 インチフロッピーディスクでもハー•••ディスクでも、あるいはその 
他のドライプでも*本的にはアクセスすることができます„それぞれのドライブやメディア 
のによりセクタの大きさ、トラックごとのセクタ ft 、Sd» 面の致など liit っていますが、 
これを統一的に管理するため、 MSX-D0S2 では，ディスク上の物理的な境界にとらわれず. 
すべてのセクタに連枝した通し番号をつけて、その番号でセクタを管®する方 i 去を採用して 
います。これを 1 ■途理セクタ J と呼びます。 

1 ■論 a セクタ j oaP. セクタ）の#号はは！)からそのディスクの炫セクタ数一1(ディス 
クの秘類によって與なる）まて•の一逢の番号によって报定します。 

MSX-D*S2 では、ディスクの中のセクタを表 2.12 に示す4つの領域に分けています。最 
初の3つの領域にはデータを管理するための情報が#き込まれ、7 r イルデータの本体は 
「データ領域 j の部分に卉き込まれます，これらのす}：茜問係は1212.3のとおりです，プートセ 
クタはかならずセクタ0にありますが、 
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鲁 FAT 

• ルー トデ■(レクトり 
• データ領域の明始セクタの位31 

は、メディアによって死なります。ただし、これらの情報は、プ_1•セクタから忒み出せ 
ば得ることができます。 


表 2J2 ディスクの銪域 


領域 内容 

ブートセクタ ディスク W ィ|•の俏银と MSX UOS2 の起觔フログラム 

FAT ディスク上のファイルとサブデイレクトリの位 Sffi 相 

ル-トデイレクトりディスク上のルートディレクトリの管理情報 
データ頷域 •夫捺のフ7•イルデータ 


期始位 E はプートセクタからわかる 


凶 2.3 ディスク上の領«の位 EM 係 


13.3.2 クラスタ 

ディスクの入出力は、前述のとおりセクタが基本取位です。ただし、ファイルに対してディ 
スクI.のセクタを拥り当てるときには、セクタではなく梅致のセクタから成る r クラスタ j 
という蜞位が使われます。それぞれのファイルには、そのフ7■イルサイズに応じて必要な数 
のクラスタが別り当てられます。1クラスタ未 a の部分については、例えそれか1パイトで 
あっても1クラスタ分のデータ領域が剖り a てられます。クラスタは論理セクタと同様に連 
統した番号で指定されていますが、 FAT の項で述べる理由で、2から始まる通し番号|こなっ 
ており、.データ領域の先®がクラスタ#2の位 E に相すIします。 
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13.3.3 ブートセクタと DPB (ドライプパラメータプロック） 

MSX-DOS2 では、抟«されている個々のドライプごとに r DPBj という領域がメモリ上 
の<7—クエリアに®けられ、各ドライプに面有の衍 ffi が aC 鉍されます。 MSX-DOS2 はどの 
ようなタイプのディスクドライブにも対 lij ができますが、それはこの UPB を参,明して flS々 
のドライプに対応した®環を行うことによって、メディア問の差異が W 収てきるからです， 
DPB に井き込まれる情報は、プートセクタにされているもので，それが MSX DOS2 
の*やメディアが交換？れるごとに変 E されます，ただし、ブートセクタと DPBU, 闵 
2.4 と K2.MI 承すように、形式が異なっています。 



26 | システムが使相する 

I • 〇 ia 外=フアイル s/ こ u サブデイレ 
が可能>, 

I ■ 0=7T イルまたはサブデイレクト 
成した （U1SDEL はできない)， 

I ボりューム 1D。 味はフォーマット時に» 
それぞれの偭は 0-127 の嫌。 


] »来のため了•約 （0 で fl 1 •めること） 


:可能なエン！' U の ft) 


タト”を別松した後. 7r イルを fr •つていない (UNDEL 
りを MHt した後， 7T イルまたはサブディレクトリを作 

l » で) aas れる， 



『ssrfl g SS s§gg lOC 1 rc£r 肝 m ^-l“ Tln lr r^ lTr eJjg 



[ ドライブ 

r id 

| セクタサイズ 


デイレクトリマスク 

デイレクトりシフト _ 

クラスタマスク（クラスタサイズー i> 

クラスタシみ- 

FAT 油 Wi の: tlffl セクタ 


FAT のコ t-ft 

ルートデイレクトリエントリ» 
デ-ダ*域の 5U6 セク？ 


tt 終クラスタ»号 < 战クラスク ft+l> 


FAT サイズ（セクタ毕位） 

ルートディレクト MS 域の先頭セクタ 


FAT ハ•ッフ T の T ドレス（システムメモリ> 


凤 2.5 DPB の稱造 


13.3.4 FAT (ファイルアロケーションテープル） 

MSX-DOS2 では、1クラスタよ U{ ■大きなサイズのファイルは、«数のクラスタにまた 
がって記»5れますが、そのと SA 枝した*号のクラスタが使用5れるとは限りません。特 
に、ファイルまたはサブディレクトリの作成除を何度も繰 1 )返した後では、便われなく 
なったクラスタがディスク上のあちこちに欧在した状想になります。この状想でサイズの大 
きなファイルを作成すると、デ_夕は飛び JR びのクラスタに分敗して S かれま1%そこで 
1 ■何番 U のクラスタは何番目のクラスタに嫌いている J、 というリンク«報を K 銶しておく場 
所か必要になります0それが FAT の役割です。また、来使 W クラスタの位两や、不良クラ 
スタが発見されたとき以後そこをアクセスしないようにする H 的にも FAT が利用され 
ます。 

FAT にされるこのようなクラスクのリン？悄*や不良クラスタ悄報は、ディスクフ r 
イルを®*!するうえで不可欠なものであリ. -- 部でも被損してしまうとディスク全体が使用 
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できなくなる恐れがあります。そのため FAT は常に複のコビーが用尨され、万一に備 
えています- 

FAT の洌を K 2.71：示します • FAT には， 

• 先®の1パイトは r FAT IDj と呼ばれ、ディスクのメディアタイプを示す侦 
•次の2パイトはダミ ー« の FFH 

• その次から、1クラスタにつき12ビットという7ォーマットで劣際のリンク W 根を K 
»している FAT エントリ 

がされます。〇番と 1* に相 S する3ハ•イトが TATIDj に使われていますので、7 t 
イルのデータに対応する FAT エントリは2番から始まります， FAT エントリの*号は、そ 
れに対応するクラスタの®号でもあリます。 FAT エントリに aC » された W ビットのリンク 
衍祐は、闻2.6のように亚んでいます。リンク fflft は、次に较くクラスタ番号を示す®です。 
もし FFFH となっているときは、そのクラスタで77■イルが終'/•したことを意味します。 

凶 2.6 の例では、クラスタ#2-*クラスタ#3-*クラスタ#4とい，3クラスタ分の大きさ 
の7 7•イルと、クラスタ#5―クラスタ#6の2クラスタ分のフ7•イルが存在していることが 
わかります。なお、クラスタが#写•の小さい順にリンクしているのは図を兄やすくするため 
で、尖除には#号順であるとは限りません。 


I — 4 K / [ —4 Kv h —J 

FAT 先 SS - I F 8 1 

+1 I F F 1 



+6 ! F F 

+7 I 6 1 F 


+8 _ 0 _ 0 _ 

+9 [ F F 

+10 I F 


FAT ID 
ダミー 

FAT エン！■り 
FAT エントリ 
FAT エントリ 
FAT エン！■り 
FAT エントリ 


2:>) ンク =003 H 
3:リンク =004 H 
4:リンク =FFFH 
5:リンク =006 H 
6:リンク =FFFH 


m n 

mi) 


闼2.6 FAT の实例 
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第 13 章デイスクフ T イルの播造 



13,3.5 ルートディレクトリ 

fat |よテ’一夕の位囲 ra 係などを衣すものであり、ファイル n 体に閱する悄报は含んでいま 
せん。したがって、そのファイルの名 m やそれに付 M する俏银を知る 1C は、 PAT と li 別の愤 
報源が必要です。これが 1 ■チ-ィレクトリ j です。 

ルートデ•{レクトリはディスク上のルートデ■(レクトリ領域にされていて、問 2.8 の 
ように32パイトごとにディレクトリエントリ（ディレクトりの格納埸所 > が並んでいます。 
7T イルを作成すると、使われていないディレクトリエントリの中で，いちばん*号•が小さ 
いところに目的のファイルのディレクトリエントリが作られます。 

ファイルまたはサプディレクトりが BI 麻されると、«当するディレクトリエントリの it 初 
の1パイトは+12 1 ■テ’■(レクトリエントリの®1文字 j にコビ_された後、 0E5H が碁き込 
まれ、そのディレクトリエントリが空いたことを示します。 UNDEL コマンドを•矢行讣には、 
この1パイトを元に民してディレクトリエントリを保话させます。 

ディレクトリエントリがすべて使川されてしまうと，データ®域がい < ら01っていても新 
しいファイルまたはサブディレクトリを作ることはできません， 


+0 

+32 

+64 

+96 



~ j 


— このエント giii® も使われていない 


凶 2.8 ティレクトリ領«の構造 

ディレクトリエントりは凶 2.9 のような構造で、それぞれフ7•イル名•ディレクト名•ボ 
リューム名，城件、作成.®新の口時、先頭クラスタ番号、ファイルサイズの愴報を iil 録し 
ています • 
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デイレクトリエントリは!思件によって，ファイル、デイレクト 1 J (デ♦レクトり域11がセ/ 
M, ホリューム名（ボ U ューム名®性がセット > を*します， 

デ •< レクト IJX ントリの551文卞 
(フアイル削除時に使 W) 



12129デイレクトリエントリの梆造 


«性は、ディレクト U エントリに各«の«性を0•えるものです （K2.1U 参照しそれぞれ 
の次のような意味を持っています • 


JftAill し ffft) ファイル 

このヒッI•がセットされるとフ T イルは*き込んだり M 除したりできなくなリます- K 
んだり、を変史したり、移動することはできます- 


小" J 视 

このビットがセットされていると.検索®性ハイト屮に•■不 "J«j ビットをセV卜し 
て r a 初のエントリの検索 j ファンクシ3ンをコールした場 ft ■にのみ ft つかります。 


• シスチムフ r イル 

MS.X-DOS2 のファンクシ3ンが M 知する限り、このビットは「新しいエントリの検索」 
と 1 ■作成 J ファンクン3ン 3 — ルが ft 勤的にシステムフ7•イルを削 K； することはない 
ということを除いて、 r 不叶视』ビットと全く同じ効果を持ちます。コマント•インタブ 
') 夕によって«み込まれたコマンドでは，システムフ t イルをアクセスすることがで 
きません。 
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» 13 隹デイスクフアイルの携 jS 


ボりューム名 

このビ v I•がセノトされるとこの; u ントりは,ボりュームの名前を： t 接します。これは 
ル'-トディレクトリでのみ可能で、ひとつだけしかぶ•定できません。 ffc の t ノトはす 
へて無規されます。 


アーカイブ 

フ7■イルが力き込まれてクローズされると必ずこのビツトがセツトされます。このビノ 
卜は、 XCOPY コマンドなどによって検出され.ファイルが変!£されたかどうかを« 
断します。 MSX D0S1 ではこのビットは常に0です。 



汶み出し專用 

いずれかの ■». を侍. 
ていると、 ■ a ，ルとI 
てアクセス■ません0 

T - 々イブ 


システム7ァイル 
ボリューム名 
ディレクトリ 


m 2 . 10 厲性 


H 付4：時刻は W 2.11 tMZ 12 のように、それぞれ2パイトの铋域を3つのビ ("7 ィール 
ドに分 W して 4 C 錄しています。 r< |- j は7ビッ（•に 0-99 の#:を找定することで. WW 1980 年 
-2079 年を表します，•■秒」川のビット7ィールドは5ビ y 卜で， W •間の分 W 能は2秒です。 

h -+25- 4* -+24 - H 

[y ‘_y L y , y L y ,_y L y i:m r m . 一 m 上 m 「 d 』 d _ メ 」 d ._<i ] 

*f- (0-99 ••- 1980-2079) H (0-12) B (0-311 


闵2.11 B 仲を表すビ 7 トフイールド 
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| h , h , h , h , h | 


^31 


秒/ 2 (0-29) 


図 2.12 時刻を衣すビット7ィールド 


13.3.6 ボリューム名 

ディレクトリエントリのボリューム名«性がセットされているとそのエントりは,1(リュー 
ム名を表します。ボリューム名はルートディレクトリでのみ役定 "r 能で、またひとつだけし 
か故: S できません • ボリューム名は11パイトであリ、コントロールコードと「ハを除いて 
フ7■イル名としては無効な文字を含めることができますが、先规に空 g は入りません。 

13.3.7 サブディレクトリ 

MSX-DOS2 ではサブディレクトリによって限ディレクトリを扱えるよう1=なりました。 
サブディレクトりはデータ領诚内にとられ、その袖域 U フ7■イルと网じように FAT で®•理 
されます。サブディレクトリの銪域にはルートディレクトりと同じようにディレクトリエン 
トリが並んでいます。ただし、この領«の®初の2つのエントりは特別な目的に使われます。 
これらのエントリはディレクトリ05性を待ち、ディレクトリ名は 「.j r _.j になります • r .j 
の先敗クラスタ*号は自分 fi 身のディレクトリを指し、 1 '..j の先•頭クラスタ*号は拽デ < レ 
ク（•リを指します。 

13.3.8 クラスタからセクタへの換算 


FAT やデイレクトりでディスク h のデータの位武はクラスタ単位て•衣わされています。 
クラスタで示されたこれらのデータを7ァンクシ3ンコールでアクセスするためには，ある 
クラスタが何番のセクタに対応しているれといつ間係を求めなければなりません。これは 
ヂータ領 W がクラスタ#2から閜始していることを元に、11下のように it •算することかてき 
ます。 


1. >えられたクラスタ»号を C とする。 

2データ®域の開始セクタを調べ、これを S0 とする。 

31クラスタが何セクタに相 ft するか P ベ《これを n とする。 

4求めるセクタ*号 S は、 S==S0+(C-2)xn の計算で得られる， 



13.4 ファイル情報ブロック ( FIB ) 


デイスク上のフ7•イルに f 竽用するすべての新しい MSX+DOS ファンクシ3ンには.ヌル 
文卞で終了する文字列 （ASCIIZ 文字列と呼ぶ）への単なるポインタを漉すことができ、こ 
の文字列にはドライプ、パス名、およびワイルドカ-'ドを使用しない確定したファイル名を 
梢定することかできます，これらは通常外部ブログラムが t に a 級 dss インタフュ—-通 
して灾行する処理です。詳細は 5.1 「衣！! e 法について』を参照してドさい。 

これらの ASCIIZ ファンクンヨンには，かわりにフ7•イル悄報プ〇ック （FIB File In¬ 
formation Block ) を抱すことができます， FIB は末知のフ7•イルやサブデイレクトリをデイ 
レクトリ上で検索するといった、より «* な*！理に使 m されます。通常、これらは37ンド 
インタ-ブリタやユーテイリティのみで使用されていて，外部ブログラムでしか使わないで 
しょ％ 

FIB U 特定のフ7•イルやサブディレクトリのディスク上のテ••（レクトリエントりの AT 相 
を侍っているユーザーメモリ中の64バイトの两域です。 FIB 中の侦報は新しい MSX-DOS 
の r 検染 J 77•ンクシ9ン（•■•初のエントリの検索 j (P.291) % •■新しいエントリの検索 j 
(P293), および 1 ■次のエントリの検索 j (P.292)) によって*たされます。 FIB の形式は次 


JI 2.13 FIB の形式 


アドレス内« 

0 粘に 0FFH 

1~13 フ7•イル名 （ASCIIZ 文字列） 

14 7 7■イル©性パイト 

15~16 fii 終変史時刻 
17-18 終変 'i£H 付 

20 開始クラスタ 
21~ 24 フ7■イルのサイズ 
25 納ドライブ 

26- 63内部悄祐（変更してはならない） 


どちらの形式のハ•ラメ'-夕もとることができるフ7■ンク-〆 a ンかあるため、 FIB の最初の 
「 OFFHj はパス名文字列と区別するために必要です。 

「7ァイル名 j は椟 P 字可能なフォーマットでストアされ^ ASCIIZ 文字列の杉式にな 
ります。空IIはすべて取り除かれ、もしあればフ T イル名抵轚子の前にピリオドが付加され、 
名前は人文字にされます-エントリがボリュームラペルであると、名前は r .j セハ•レータな 
しでストアされ、空白が残されて大文字化されません， 
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• t，/ 卜0 - 忒み出し痒用 

このビットがセットされるとフ7•イルは込んだ0削 B： したりで S なくなりますが 
说んだり、名前を SJE したり、移助することはで§ます。 

•ビット1不可视ファイル 

このビットがセットされてぃると， r 4MU のエントリの検索」7ァンクシ3ンを、検； fe 
Wtt パイト中に r 不可视ファイル j K ットをセットしてコールした*為合にのみ、 7T イ 
ルが R •っかります。 

3マンドインタープリタに姐み込まれたディスク上の7 7•イルやディレクトリにアク 
セスするすべての:！マンドは、 r /Hj オブシ3ンを枏£すること C よって不_イ«17ァイ 
ルを Sd っけることができます， 

• ビ7卜2-システムファイル 

MSX-DOS のファンクシ3ンに問する限り，このビットは、 1 ■新しいエントリの検索 j 
と「作成』フ r ンクシ a ンコールが H 勒的にシステムフ7•イルを№1除することはなぃ 
ということを除いて、ファイル」ビットとまったく同じ幼栗を持ちます•コマ 
ンドインタープリタによって H1A 込まれた：>マンドでは，システムファイルをアクセ 
スすることができません。 

• ヒット3-ボリエーム名 

このピ v 卜がセットされているとこのエントリはボリュームの名|班です。これはルー 
トティレクトリにひとつだけしか ff 在できません。他のビットはすべて無視されます。 


•ビット4ディレクトリ 

この t ツ t ■がセツトされてるとこのエントリ U ファイルではなくサブデイレクトリで 
す，したがって通み出しや鲁き込みのためにオ_ブンできません，サブディレクトリ 
の場合は、 1 ■不 H 视ファイル」ビットだけが S 味を持_ちます。 

•ビット5アー*イプビット 

7ァイルが? f き込まれてクローズされると必ずこのピットがセットされます，このピッ 
卜は. XCOPY コマンドなどによって、ファイルが変 K されたかどうかを判断するた 
めに、検奔できます。 

*t- ノト6予約（常に〇> 

•ビット7デバイスビット 

これがセ-/卜されていると FIB がディスクフ T イルでなぐ文字デバイス （ r CONj な 
ど）を麥照していることを示しています，他のすべての«性ピットは無視されます- 
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「W 柊変史時刻 j は次のように2パイトにエンコードされます。 

衣 2.14 最終変 E 時刻の2パイトエンコード 


ビット 念昧 
15-11 時間 (0-23) 
10- 3 分(0~59) 

4- 0 秒/2 (0-29) 


U 次のように2パイトにエンコート•されます e すべてのビ:/卜がゼロで 
あると， U 付がセットされていないことにな 1 )ます • 

衣 2.15* 終!*: KU 付の2ハ•イトェンコ--ド 


ヒ y 卜 fiM- 

15-9 年 （0~ 99. 1980 ~2079に対応〉 
8- 5 H (1-12 • 1 H -12 月 Iゴ 
4- 0 H (卜 31) 


1 ■ファイルサイズ j は®ド位.パイトが先敗にストアされた32ビットの SWt で、サプデイレ 
クトリでは0です。 

「論琿ドライプ J は1バイトのドライブ«号で、1が A:、 2が B: というよ -5 に対応します。 
元のフ7•ンク•〆!！ンでゼロが衍定された場合（それは#レントドライプという) K 味なので> 

冷レントドライプのドライプ* ここに入れられるため、ゼロになるといつことはあ 》J ま 

せん。 

1 ■内部情報 j によって、 MSX-DOS (i ディスク上のどこにデイレクトリエントリがストア 
されているかを知ります，こ fL によって FIB を!®された7ァンクシ3ンで、例えば削除、名 
前の変史ゃオープンなどの，デイレクトリエントりに対する処理ができるようになります， 
また、ここにストアされたデータによって、•■次のエントリの検索 j フ T ンクシ3ン (P.292 
备照> が次に一致するフ T イルの検索を実行できます。 

ユーザーは内部の情報をアクセスしたり修正した9してはなりません。 

FIB(i r tt 初のエントりの検索ム•■斬しぃエントリの検索八および•■次のエントリの検 
3kj MSX-DOS 7ァンクシ3ンによってき込まれます，これらのフ7■ンクン s ンはディレ 
クトリエントリを探し、 A 切な«報を FIB に叩き込みます。 

r fli 初のエントリの検索 j の場合には、ディレクトリは指定のファイル名に一致し，適合 
する厲性を持つ圾初のエントリについて検索されます（詳細については 17.3 「ファンクシヨ 
ンの； ii 明 j を多. W)。 •■次のエントリの検索 j は直前の r « 初のエントりの検索 j ファンクシ3 
ンによって始められた検索を実行し、次に一致するエントリで FIB を更新します。 



「折しぃエントリの検索 j (P.293 癸照）は r ® 初のエントリの検索 j に W 似してぃますが， 
一致するエント U を検索するかわりに析い、エントリを作成し、「&初のエントりの検索 j で 
a つかったのと R 様に FIB を返します 

「梭索 j フ7•ンク y ョンのぃずれかで FIB を作成すると、それは2つの方 i 去で利用するこ 
とができます。 

Sk 初の， iil はファイル名やサイズなどとぃった、それが持ってぃる情®を单純に利用する 
ものです。例えば， f DIRj コマンドは单縫に怙報を IW 面に出力します • 

FIB を使用するもう1つの方法は.ディレクトリエントりにつぃてのなんらかの処理を戈 
H •するために、それを«>つ1 &S りの MSX-DOS2 ファンクン3ンに渡す方法です， 

17.3「ファンクションの说明 j で記述されてぃる MSX-D0S2 フ7•ンクションの多くは 
DE レジスタに入ってぃるボインタを、ドライブ•パス•フ7■イル文字列あるぃは FIB のど 
ちらかを指してもよぃものとして使用します，どちらの場 ft •も、フ7•ンクシ s ンには尖行の 
対象としてキ专定のフ7•イルやディレクトりが指定されます。 

のようなノ<ラメータを取ることのできる7ァンクシ3ンは•■フ r イル A るぃはサプデイ 
レクトリの削除. （P.3W# 照)、「フ7■イル名あるぃ tt サブディレクトリ名の変更 j (P.305# 
照）、 r 7 ァイルあるぃはサブディレクトリの移 »j (P.306 参照)、 r 7T イルの EHJ お t ぴ時 
刻の®得•セット J (P.308# 照）、および >"フ7•イルハンドルのオープン j (P295# 照 > で 
す。これらのすべては、のファイルあるぃはディレクトリにつぃて、所定の檐 fi6 を笑け 
します- 

FBI は r 最初のエントリの検索 j あるぃは「析しぃエントリの検索 j ファンクシ3ンへも 
ドライプ•パス•ファイル文字列の代わりに®すことができます。この場分， FIB はファイル 
ではなくディレクトりを#照しなければならず、ファイル名文字列を HL レジスタで拽さな 
ければなりません（通»ヌル文字列で、こ<1 はと同じ .& 味)。 FIB で析&されたデイ 
レクトリでは、ファイル名とマッチするものが検索され、通常の Wtt のチェックを受けます。 
この檐能はコマンドインタープリタで、 UTIL がディレクトリである場 ft •に r DIR A:UTILj 
などとぃったコマンドが必要な動作を实行するために必*です。 

13.5 ファイルコントロールプロック （ FCB ) 


MSX D0S2 の外部ブ〇グラムや MSX-D0S2 用に修止された MSX DOS1 や CP/M のブ 
ログラムが CP/M 換の FCB ファンクシ9ンを使用することは想宏されていませんが、こ 
れらのファンクシ9ンで使用される FCB のフォーマ:/卜を参考のために： ii 明します。 

このフォーマッ（•は CP/M や MSX D0S1 で使用される FCB に非常に似ていますが， FCB 
中のいくつかの®域の使用法は兴なります。 

基本的な FCB の长さは33パイトて•す。このタイプの FCBti ファイル管理換作（削除、名 
m の変史など> や、シーケンシャルな忒み丑きで利 W できます-ランダムな狡み#きのファ 
ンクンヨンは.ランダムレコード番 y を格納するために FCB の後から更に3バイト使用し 
ています> MSX.DOS1A 換のプロックリード*ライトのファノクシン6この追加の3バ 
イト（場合によっては4バイト）を使用します。詳細については 17.3 1 ■フ T ンクシヨンの説 
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W|j を在•明してドさい， 

FCB のレイアウトを以 J •'にホします • それぞれの領域の大まかなここに s いてあ 
ります。17.3 •■フ7■ンクシ9ンの说明 J で sC 述されている個々のフ r ンクンヨンの a 明では， 
M 域かそれぞれの7 7•ン 9、ハ ンでどのように使 M) されるかが;#しく说明されています。 

• 00H ドライプ S5J- (1-8 。〇以下ならは•カレン ！• ドライブ） 

他 JIJ されるすべての FCB でセットアップされなければならず. MSX-DOS のファンク 
ンコ.ル変れ 「 APPENDj が使川されている場合の r ファイルのオープン 
(FCn]j (P275 亊照〉を除く）では変史しません， 

• 01H-08II フ7•イル名（左 K めにして後に空 H が WO 

フ r イル名にワイルド*ー ドが tt 用できる場合には 「?j、「*j 文宇を含むことができ 
ます （R275 •■フ t イルのオーブン [FCB|j を#.明）。比較を行う場 ft、 大小文字の区 
別は無柷されます。铕しいファイルを作成する埸合、«萌は大文字にされます. 


09H-0BH フ7■イル名 

ファイル名と同じです。7アイル名柢張チの文宇のビット7は CP/M と興なリ、フラ 
グとして解釈されません。 


• OCH- エクステント番号（下位バイト） 

外部ブログラムによってオーブンや作成の IW に（通常ゼロに > セ， y I•されなければな 
0ません， 

これ (1 シーケンシャル IJ ー ド•ライトによって使«1、 KW されまた，ランダムリー 
ド*ライI■によってセットされます。 CP/M および MSX-DOS1 と互携件があ 1 )ます。 
• 籲 DH- フ t イル Wtt 

••フ T イルのオーブン j (P.275IMH)、 1 ■ファイルの作成 j (P.280 事照）と r 最初のエン 
トリの検索 j №.277参照）によってセットアップされます， 

• OEH 

CP/M ファンクションでのエクステント番分 （ I•.位パイト） 

才ーブンと作成によってゼロにされます-•ケンンヤルりード•ライI•では，エクス 
チント潘号の拡張として使 IH、 史新され、 CP/M でアクセス可能なものよ 1 )大きなファ 
イルをアクセスできるようにします。これは CP/M とは異なるが、 CP/M ttl： FCB 
を使用する妨げにはならず、 MSX-DOS1 と同じです- 

MSX-DOS1 换のアロック77■ンクシ3ンでのレコードサイズ（下位パイト） 

プロ v クリード•ライトファンクシ3ンを使用する前に，必要なレコードサイズにセ•ノ 
卜しなければなりません。 

• OFH CP/M ファンク*〆ヨンのレコードカウント 

オーブンおよび作*によってセットアップされ》シーケンンャルおよびランダムリー 
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ド*ライトによって必要に応じて任 ill されます。これは CP/M および MSX-D0S1 と 
同じです。 

MSX DOS1 ft 換のプロック77■ンクシヨンでのレコードサイズ（上位バイト > ブロ •/ 
クリード•ライトファンクシ 9 ンを使用する谪に、必®なレコードサイズにセヴI•し 
なければなりません。 

.10H-13H パイト单健でのフ7•イルサイズ （W 下位パイ（•が： W 初） 

フ7■イルサイズは£確なもので、128バイト嗒位に切り上げられません。この欲域は 
オープンおよび作成;によってセットアッブされ、フ7■イルが込み«:理によって拡 
張されたと SK9J+ 新されます。クローズ77■ンクシ3ンコールによってディスクに# 
き込まれるため、外部プ〇グラムが«疋してはいけません。これは MSX-D0S1 と同 
じですが、ここに別り气て悄報を柄する CP/M とは興なリます。 

•14H-17H ボリューム ID 

これは、この FCB がアクセスしている特定のディスクを SS 別する4バイトの»値で 
す。オープンおよび作成によってセットアップされ、 a み出し、 ■» き込み、およぴク 
13—ズコールでチ X ックされます。プ〇グラムによって変 K してはいけません。これ 
は、ここに ft 終 E 斬13付および時刻をストアする MSX-DOS1、 拥り丐て情報を格納す 
る CP/M とは*なります。 

•18H-1FH 内部 W 相 

これらのバイトはフ T イルをディスク上で見っけるための ffi 银を持ちます。外®プロ 
グラムによってはいかなる変更もしてはいけません。ここに保持されている内部 
は、 MSX-DOS1 によって保持されるものと似てはいるが P1 —ではなく、 CP/MOt 
のとはまったく異な 1 )ます， 

• 20H エクステント中の*レン！•レ3-ド（0~127> 

«初のシーケン•✓ャルリード•ライトの前に外穿>プ〇グラムによって （i** ゼロに）セツ 
卜され.なければな9ません，シ_ケン〆ャルリード•ライ！'によって使用、変 E され 
ます。また，ランダムリ_ド•ライトによってセット T ッブされます。これは CP/M 
および MSX-D0S1 と互 ft 性があります。 


• 21H~24H -ランダムレコ-ド番号（下位パイトが先） 

この領域はオブシ s ンで，ランダムあるいはブ〇ックリード•ライトか使用される場 
合にだけ必要とな 1 )ます。これらのを尖行する|»にセット7ッブしなければなら 
ずプ〇ックリード*ライトによって K 新されるが、ランダムリード•ライトによって 
は更新されません，•■ランダムレコードのセッ！ "J 7アンクシ3ンによってもセットさ 
れます。 

ブロ 7クリ ー (•••ライト (MSX-DOS1 に存在して CP/M には存在しない）では、レ 
コードサイズ A*64 パイト来滿の場合には4バイトすべてが使用され、レ3— ドサイズ 
が64パイト以上の場合には tt 初の3バイトだけが使用されます。ランダムリード•ラ 



イトは a 初の 3 パイトだけが使用されます（畴無のレコードサイズは128バイト）。こ 
れは CP/M および MSX-DOS1 と互換件があります。 


13.6 環境変数 

MSX DOS2 はデータセグメント中に境変数 j の U ストを持ってぃます。设境変数と 
は、 MSX- IJOS2 やアブリケーシ3ンプ〇グラムが，脚Vするときに必要となる缻を»定して 
おく 4!数です。 K 境変«には、 DOS2 やアブリケーシ3ンブ〇グラムが使坩する特定のもの 
と、ユ••ザーが定義できるものとがあります，名成と械はどちらもユーザーが定雜します。 
琛埂変数は「現境変数の獲得 j (P.328# .明)， 「S 境のセット j (P.328# •明）ぉよび「61 
堍变数の検索 j ファンクション0 > .329费照> を ili してファンク；/3ンコ_ルレべルでアクセ 
スすることがてきます。 

说境変»の名前はファイル？;で使用できる仔荩の文字で W 成されるヌルでなぃ文字列です。 
SJ 境*»は255文字の£さまで;^されます，5!境変 ft:i 文字 M が:£36されると S に大文字に 
変換されますが、名 M が 1M4 されるとき<1、大小文字の区別をしません。 

S 塊変致の谈はヌルでなぃ文字の文字列で供成され，255文宇までの ft さが吋能です-琛 
境*数の値がヌル文ネ列にセットされると、名薊は«塊？ Ett のリストから除去されます。 IBJ 
様に、 4* されてぃなぃ斑境変«の値が31み出されると、ヌル文字列が返されます•妞は人 
文卞にされず、械の文字列中の文宇につぃては何の*換も行われません。 

外部ブログラムが〇-■ドされ COMMANU2.COM から実行されると、外«ブ d グラムが 
MArti すことのできる2つの特殊な««変数がセットアップされます。 

PARAMETERS とぃう®境*数は;のコマンド名を含まなぃ 3 マンド行の内容です。こ 
れ U、CP/M との ft 換性のため、 80H にセットアップされるものと似てぃますが、大文字に 
li されません* 

PROGRAM とぃうもうひとつの変 ft は、ディスク上のブ〇グラムを ft つけるために 
使用される完全なパスで、ドライブ、ルートからのパス、プ〇グラムの货 B のファイル名の 
1«になってぃます，ドライプ，パス、およびファイル名 li 1 ■パス名の WWj ファンクシ*ン 
3-ル （P.314 参照）を使用して分離することができます， 

PROGRAM S 境変 «t にはぃくつかの使用法があります，主要な用途はプ〇グラムがそれ 
を、ブ〇グラムがロードされたところと同じディレクトリから才ーバーレイファイルを口一 
ドするために利 111 できることです。 PROGRAM 中の*後の項目（つまり実際のブログラム 
のフ r イル f,> を才ーパーレイフ7■イルの名前に莳き換えて、新い、文字列を ASCIIZ 文字 
列を取る ffffi の祈しぃ MSX-DOS2 ファンクシ s ン （> ■ファイルハンドルのオープン j など） 
(こ跄すことができます。 

CP/M プ〇グラムのぃくつかは外部プ〇グラムを D- ドして： Ji 行することができますが 
この塲 ft CP/M ブ〇グラムは PROGRAM や PARAMETERS ® 境*数をセ y トア •/ ブし 
ませんので、琛埃变敢は CP/M ブ〇グラムが D — ド5れたときのままになってぃます。 

ブ〇グラム/) <PllOGRAM および PARAMETERS を使用しようとして、しかも CP/M プ 
〇グラムから& ロードできるよ，にしよ7とする場合には、ページ0の0037 H »地にある 
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「LOADJLACJ」 という* ft を»ベることかできます。このフラグは.すべての MSX-DOS2 
のフアンクシ3ンコールでゼ〇にセットされ，外®ブ〇グラムが COMMAND2.COM によつ 
て•其行される直前にはゼロ以外の値にセットされます。 MSX -DOS2 用の外部ブログラムが 
他の外部ブログラムを口ードして実行できる場合， PROGRAM と PARAMETERS をセッ 
トア:/ブするには， COMMAND2.COM とに LOADJLAG をゼ〇以外にセットしなけ 
れぱなりません。 

もうひとつの特殊な®境変数は APPEND です 0 これはユーザー!》*コマンドインターブリ 
夕からセットアップし， CP/M のI■ファイルのオーブン (FCB)j フアンクシ3ン (P.275# 
照）で使用されます。このフ7•ンクン3ンコールが芡行されてフ r イルが見つからないと， 
APPEND で定される別のディレクトリが検索されます，ただし、 MSX DOS2 用の外部 
ブログラムがこのファンクンコールや APPEND 環境変数を使用するということは考え 
られていません。 

種々のシステムの機能やオプションを制御するため、いくつかの環境変数がコマンドイン 
夕ープリタが起»するときにセットアップされたり、ユーザーによって変 C されたりするの 
で，外部ブログラムでそのいくつかを SI み込むと便利です，例之ば、 PATH® 塊変数や.ブ 
ログラムが Bf.J •や時刻を出力する場合には DATE や TIME® 境変数を統み.込む tft 利です。 
8¢ <15境変数の設定 j ではこれらのデフォルトの®境変数の詳細を記述しています。 



14 章 

画面制御コード 


以下 K 示すの14、 MSX--DOS2 の文字 7T ンクシ a ンによる文字の出力や BIOS コ—ルを突 
行するとき、あるいは CON デパイスへ* くときに使用することができるすべての制卻コー 
ドとエスケープシーケンスのリストです。これらは MSX-DOS1 と互換性があ9、 VT-S2 制 
御コードを含みます，画面は2—80文字X 24行です，印字可能文字が表示されると々ーソル 
は次の健 K に移助し、行の終わりの場合には次の行の先»に移助します，文字が画面の右下 
に*かれると、画面はスクロールして次の行の*初に* —ソルを S きます0エスケーブシー 
ケンス中の文字は大小文字の区別を正 L く 行わねばな*) ません • また、 K みやすいように空 
n が入れてありますが、空白はシーケンスの一部ではありま- it ん，数値 （<n> や <m> で示さ 
れている > は通常 20H のオフセットを加えた摩•ーパイトとしてンーケンス中に含まれます。 
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第14夺两面制御コ〜卜 


£ 2.16 制御コード 

シーケンス コード棟能 
CTRL+G 07H ペル 

CTOL+H 08H 々ーソルを左に，前の行にラッブアラウンドして®面の左卜. 

で停止. 

CTRL+I 09H タブ • 次の8番日のカラムまで空臼で埤め、次の It の始めに 

ラップアラウンドし、画面の才 r'F でスクロール。 

CTRL+J OAB 改行0画面の最下行ではスクロール， 

CTRL+K OBH カーVルをホームポジションへ》 

CTRt+L OCH 幽而をクリアして*-ソルをホームポジ1/ 3 ンへ〇 

CTRL+M ODH 觸。 

CTRL+t 1BH エスケープ（後のエスケープシーケンスを#照）。 

CTRL+* 1CH 力—ソルを右に•次の行にラップアラウンドして W 而の右下 

で停也 • 

CTRL+] 1DB 力ーソルを左に•的の行にラップアラウンドして W 面の左上 

で停止。 

CTRL+"' 1EB ソルを上に。圃面の一*上で伴止- • 

CTRL+_ 1FH 力ーソルを下に。_面の 一S 下で停止。 

_ 7FH 文字を削除して*ー ソルを左に移助。 

册の行にラップアラウンドして阃面の一*上で停止。 
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衣 2.17 エスケープシーケンス 


1BH 41H 
1BH 42H 
1BH 43H 
1BH 44H 
1BH 45H 


1BH 6AH 

1BH 4BH 


ESC X 4 1BH 78H 34H 

ESC x 6 1BH 78H 3SH 

ESC Y <n><m> 1BH S9H <n> <m> 


ESC y 4 1BH 79H 34H 

ESC y S 1BH 79H 3SH 


，能 — 

力-ソル i 上に。_面の-#1:で怜止.. 
力_’ノルを下に。内面の一恭 T で挣止。 
«—ソルを右に。行の柊わりで停止《 
亡ーソルをス:に，行の始めで停止。 

WlW をクリアしてカーソルをホ-ムポジ 
ションに移#)!する。 

泠ーソルをホームポジシ3ンに移 •}» する。 
« — y ルはそのままで，函面'の一*下ま 
TSi 去する。 

两曲をクリアして«—ソルをホーム, "S ジ 
シ a ンに移财する。 

力ーソルはそ，ままで、行の終わりまで 
明太•する。 

*-y ル行の■■に行を»入し、_面の残 
りの;8分をドスク〇—ルする，#—ソ 
ルは新い，空■の始めに两く， 

行全体を诮去■る。カーソルはそのまま。 
カーソル行を■■除し、の残りの部分 
を上にスク〇ルする。力ーソルは次の 
行の Ai 切に S 。 

ブ d ックカー-ルを迸択する。 

力ーソルを表•■しなぃ。 

亡ーソルを行 in> 列 <m> に茜く。 

両血のた I-JR » fi=m=20H (空 fl)。 

々ーソルの形 H をアンダーラインにする。 
々••ソルを表ボする， 


15 章 

マツノ、。ーサポートルーチン 


MSX-DOS2 に fi メモリマツパーのサボ_卜を提供するルーチンが舍まれています，これに 
よって MSX のアプリケーシ s ンブログラムや MSX DOS の外部ブログラムは、 RAM ディ 
スクや他のすべてのシステムソ7トウェアと衝突することなしに、基本の 64K のメモリよ0 
も多くのメモリを使用することができるようになります， 

15.1 マッパーの初期化 

MSX マシンでは、 DOS のカーネルは初期化される際，システムにメモリマッパーが存在 
することをチ*ックし、メモリマッノ<_上に flfc 低 128K の RAM が存在していることを確認 
します。®低 128K のマッパー RAM が存在するス〇ットが1つでも見つかると力-ネルは， 
それらのうち最大の RAM 容 fi を持つスロット（同じ容设のマッパースロットがある場合、 
- »号の小 1 ! ■ - ^ «气として使用できるようにします。 

このス〇ットをプライマリマツパースロツトといいます。メモリマッパー上に十分なメモリ 
がないと、 MSX-.D0S2 は立ち上がりません， 

MSXturboR7 シンでは、常にス〇ツト 3-0 がブライマリマツパースロットにな9ます。 
次に力ーネル li、 ブライマリマ v パース〇ッ h で利用できるすべての 16K の RAM セグメ 
ントのテープルを作成します。 ユーザー 用の 64K を構成する®初の4っと*6大きい*号の 
付けられた2つのセグメントはシステム用に割り当てられ、そのひとつは DOS のカーネル 
コードに、もうひとつは DOS のネルの作業領域として割り当てられます。他の （ft 低 
2つ）セグメントは初期状雄では未使用として登©されます • さらにカーネルは（もしあれ 
ば）その他のマッパー RAMXO ットについて、同様のテープルを作成します。これらのセ 
グメントは初期’妆班ではすベて未使用として2録5れます。 

15.2 マツパー変数とルーチン 

マ/パーサポートルーチンは MSX-.DOS のシステムエリアにあるいくつかのテーブルを 
£新します。これらのテーブルはユーザーブ a グラムから参照して棰々の目的に利用するこ 
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とはできますが、絶対に変更してはな 1 )ません。テーブルの内容を以ドに示します。 

£. 2.18マ y パーサボートルーチンが C 斬するテープル 
アトレス 栈能 

+0 マッパ--スロットのスロットアドレス。 

+1 16KRAM セグメントの筘数。 1-266 <プライマリでは 8-2SS〉， 

+2 未使用の 16KRAM セグメン|•の数。 

+3 システムに钿リ当てられた 16KRAM セグメントの数（プライマリでは 

fttte)。 

+4 ユーザーに割り;6てられた 16KRAH セグメントの数。 

+5-+7 システム予約，常にゼロ。 

+8- 他のマッパースロット<»教）のエントリ • なぃ場 fV+8 はゼロ • 

プログラムは種々のサブルーチンを呼ぶこ t によってマッパーサボ' トルチンを使用し 
ます-これらのルーチンは、 MSX DOS のシステムエリアにあるジャンプテー7•ルからアク 
セスすることができます。ジャンプテ-ブルの内容は以ドのとおりです • 


表 2.19 ジャンプテーブルの内辞 


アドレス エントリ？； 機能 

+0H ALL^EG 16K のセグメントを別り当てる， 

+3H FRE_SEG 16K のセグメントを解放する。 

+6H RD.SEG アドレス A:HL から A にバイトを統む。 

+9H UILSEG E からアドレス A:HL へバイトを鲁く。 


CAL.SEG 

+FH CALLS 
+12H PUT.PH 
+15H GET.PH 
+18H PUTJ*0 
+1BH GETJH) 
+1EH PUT-PI 
+21H GET.Pl 
+24 H PUTJ>2 
+27H GETJ>2 


セグメント M コール。 IY:IX のアドレス， 

セグメント HB コ_ル》コ_ル命令の後の行のアドレス。 
セグメントをぺージ （HL) に苈く。 

ぺージ （HL) の現在のセグメントを得る。 

セグメントをページ0に笠く。 

ページ0の現在のセグメントを得る。 

セグメントをページ i に茜く。 

ページ1の現在のセグメントを得る。 

セグメントをページ2に S く。 

ページ2の現在のセグメントを得る。 


+2AH PUT.P3 

+2DH GET，P3 


ページ3は絶対に変 E してはならないため、サボートされて 
いない，コール？れると r H0Pj のように動作する。 

ページ3の現在のセグメントを得る。 



ブ〇グラムでこれらのアドレスを得るには、マッハ•ー サポートの拡張 BIOS コールを使用 
します。これは将米のバージョンでアドレスが変 K される，あるいは MSX-DOS2 以外のマソ 
ハ•ーサボートルーチンを使用できるようにするための処菝です。 

拡張 BIOS を使用するには以ドのようにし!ますブ〇グラムはページ3の FB20h にあ 
る r HOKVLDj のフラグを调ベます。このパイトのビット0 (LSB) が0なら、拡張 BIOS 

はく••せず、マゾバーサボートもありません。ここが1の場命、以 +t ••に述べる r EX1 'BiOj ¢0 
エントリはセッ（•アップされており，«々のパラメータを持ってコールすることができます， 
ただし、 MSX-DOS がすることが確•灰なアプリケーン3ン（例えばディスクから d - ド 
されるプ〇グラム）ではこのチIックは不*で、 K ちに次のステ y ブに進むことができます- 

次にプ〇グラム! t D レジスタに拡 * BIOS のデべイス®号、 E レジスタにファンクション忝 
号を人れ，必要なパラメータを他のレジスタに入れ、ページ3の 0FFCAH にある r EXTBI0j 
をコールします。この際スタックポインタはページ3になければなりません，衍定したテ•パ 
イス*号の拡張 BIOS が存在する場合，レジスタ （AF、BC および HD はファンクション 
に応じて®®され、存在しない埸合、保存されます。 DE レジスタは*に保存されます-た 
だしいずれの壤合も、典レジスタ （AF’、BC’、DE •および HI；) とインデックスレジスタ 
(IXおよび IY) は破壊されます。 

マノパーサボートの挞银 BIOS で利用できるファンクシ s ンは以下のとおりです。 

• マ •/ パー炎数テーブルの搜得 
パラメータ A =0 

D =4 (マツパーサボートのデバイス#•全） 

E =1 

結果 A =プライマリマツバーのス〇ットアドレス 

DE=fSUJ される 

HL= マヴパー* ft テーブルの先政アドレス 
• マ— サポートル_チンアドレスの播得 
パラメータ A =0 
D =4 
E =2 

結果 A =ブライマリマ-/パーの総セグメント数 

B =7•ライマリマッパーのX 〇ット番号 
C =7■ライマリマッハ•一の朱使用セグメント数 
DE= 保存3れる 

HL= ジャンプテーブルの先賊 T ドレス 

これらのマ-/バーサポートの拡張 BIOS 自体では A=0 であることは待に必要で! i あり 
ません。しかし、マツパーサボートルーチンが存在しない場介、レジスタ頌は変16さ 
れず7ッパーサポートルーチンがする場合、必ず A に0でない侦が返されること 
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15.4 セグメントの割り付けと解放 


.1 1 1 . 睡 . m r—^s i I - ■ — bh i ' b i ■ Ji it > i I AF 

BC 以外のすべてのレジスタは保存されます。エラーはリターンの除にキャ ij ーフラグがセ v 
卜されることによって示されます。これらのル_チンがコールされると&にはス〇ットの进 
択と RAM のページングはどのような狀想にあっても»わず、どちらも ffffS れます。 スタ、/ 
クはこれらのルーチンのどちらがコ■■ルされる場合でも、ページ0あるいはページ2にあつ 
てはいけません。 

プ D グラムはこれらのルーチンにより明ポ的にセグメントを割り付けない限リどのセグ 
メントも（基本の 64K を供成する4つのセグメントを除いて）使 W してはならず，解放した 
後はそのセグメントを使用し较けてはなりません。 

セグメントはユーザーセグメントあるいはシステムセグメントのどちらかとして®1リ肖て 
ることがで？ます。两老の相通はブログラムが符了するとユーザーセグメントは自励的に解 
放されますが、システムセグメントは解放されないという点です，プ〇グラム H 体が終了し 
た後でもセグメント中にデータを必要とする場合を除き，ユーザーセグメントとして M0f、l 
けて下さい，ユーザーセグメントは常に极小の S 号の未 tt 用セグメントから釗り付けられ 
システムセグメントは ft 大の*号から荆リ付けられます。 

「セグメントの削り付け j からのエラーは、通常七使用セグメントがないことを示します 
が、 A および B レジスタに不 F なパラメータが波 S れたことを示す場もあリます。「セグ 
メントの解放 j からのエラ_は指定のセグメント*号が#在しないか、あるいはすでに解放 
されていることを示します。 

ALL^EG (ALLorate SECnient) 


結果 


A=o ユーザー セグメ v KOW り付け 

A=l システムセグメントの和!り付け 

B=0 プライマリマッハ•一の別り付け 

B?M) 搀数マッパーサボー(•による割り付け 

FxxxSSPP X 〇 ットアドレス （0 の祺合ブライマリマッパ 
xxx=000 柑定のスロットのみ別り付け 
xxx=001 指定のX ロット以外の91り付け 
xxx=010 柑定のスロットで割り付けを試み， 

失敗の*6合他のスロット（あれば》を汉みる 
xxx=01 1指定のスロット以外で H リ付けを拭み 
失敗の場 fttBa のス〇ットで試みる 
キャリーセ，/卜=未使用セグメントがない 
キャリークリア=セグメントカ< 別り W •けられた 
A= 割り付けられたセグメント番 t 

B= マツパース D ツトのスロツトアドレス 
(B=0 でコ—ルされた場合は0> 
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FRESEG (FllEe SEGmrnt) 

パラメータ A= 解放するセグメント番皆 
B=0 ブライマり vv パー 
Bj£0 プライマリ以外のマ7パー 
結采 キャリーセット=エラー 

キ ャ りー クリア= セグメント の解放に成功 

15.5 インターセグメントリード•ライト 

次の2つのルーチンは ff® のマ.ソバ— RAM セグメントの1パイトのデ-夕をりード.ラ 
イトするために用 .ff •されています。コール. T 順は MSXv ステム ROM によって提供される 
インタース〇ヅトリード•ライトルーチンと非常に似ています。 AF •以外のすべてのレジス 
夕は保存され、セグメント番号が有効かどうかを確;2するためのチェックはされません， 
セグメント* y により任意の 16K のセグメントを4つのぺ_ジのどれにも报定できるた 
め、アドレスの上位2ビットは無视され、データは常にべージ2を通してリード*ライトされ 
ます。データは現在のベージングあるい U ページ0およぴ1における Xo ットの进択に脚わ 
ちず、指定されたセグメントとのリード•ライトが行われますが、これらのルーチン)^コー 
ル される とき には、マ •/ パー RAM スロットがべージ2に迸択されていなければなりません。 
これは、アクセスを， Siii にするため、スロット切り換えを行わないからです。また、スタ/ 
クはページ2にあってはなりません。これらのルーチンは WI 1 ) 込みを襄止して戻ります， 

RD_SEG (ReaD SEGment) 

パラメータ A=i51 み出すセグメント«号 
HL= セグメント内のアドレス 
結果 A =そのアドレスのパイトの® 

その他のすべてのレジスタは保存される 

WR_SEG (WRite SEGment) 

パラメータ A =卉き込むセグメント番号 
HL= セグメント内のアドレス 
E=» き込む値 
轜采 A= 破され* 

その他のすべてのレジスタは保存される 


15.6 インターセグメントコール 

インターセグメントコールをサポートするため，2つのルーチン:^用意されています。こ 
れ b は MSX のシステム ROM で提供されている2つのインターXロットコールをモデルと 



しておりその使用法も#常に似ています。 

されたセグメントが突際に存在するかどつかについてのチェックは行われないため，こ 
れを確認するのは. 3 --ザーの资任となります。コ'■•ルされたセグメントは指定されたアドレ 
スのべージにページングされますが、これらのルーチンはいずれ （)X0 ットの迸択を変!£し 
ないため.マッパ—スロットがこのページでイネーブルされていることを確認するのはユー 
サーの贵任になります。これによって、ルーチンは35逨になります。 

ページ3へのインターセグメント： 》- ルは実行することができません。これを実行しよう 
としても，ページングは行われず， ffi 定された7•ドレスが»にコールされるだけです。また， 
ページ0を：ルする 1SAU. ページ0には剖り込みやその他のエントリポイントがあるた 
め、惧®に H なって下さい。これらのコールでスタックが切り換えられるページと®なら 
ないように注®して下さい。 

これらのルーチンはインタースロット 3— ルと遠って r— ルされたル'-チンへ制御を；®す 
的に別り込みを期止するということはありません。したがって； J ールされたルーチンで拥リ 
込みフラグを変更しない限り，呼び出し側へは M じ状態で)5!リます， 

インターセグメントコールルーチンで内部的に使用されるレジスタ IX^1Y, AF’、BC’ 
DE’ HL’ にはバラメータを渡すことはできません。これらのレジスタはインターセグメン 
トコールまたはコールされたルーチンで破埭されます，他のレジX夕 (AF. BC. DE お 
よび HL> はコールされたルーチンへそのまま渡され、そこから崢ぴ出し側へ返されます。 

CAL_SEG (CALI SEGment) 

パラメータ IY= コールされるセグメント S 号 
IX= コールするアドレX 

AF BC、DE、HL がコールされたルーチンに雎される 
その他のレジスタは破壤される 

結果 AF BC DE HL IXおよび IY が 3— ルされたルーチンから 

返される。この他のすべて li 破期される。 

CALLS (CALL Segment) 

パラメータ AF BC DE HL がコールされたルーチンに渡される 
その他のレジスタは破壞される 

3—ル手顺 CALL CALLS 
DB SEGMENT 
DU ADDRESS 

結果 AF、BC、DE, HL、IX および 1Y がコール？れたルーチンから 

返される。この他のすべては破壞される。 
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15.7 ダイレクトべージングルーチン 

以下のルーチンはプログラムがハードウ: t アをアクセスする必要なしに、抟视在のベー 
ジング 4 太® を拔作するために用意されています。 このルーチンを使えば、ハードウエアの細 
かい部分に逢いがあっても31檐性が確保できます。これらのル—チンは非常に商速なため、 
これを使用することでブログラムの効丰に釤奪することはあリません。 

ルーチンは任®の4つのマッパーレジスタに対する ift 接 1 )—ド•ライトと同等の榷能を fS 
供するため1こ用®されます。セグメント S ■号の冇効性についてのチXックはされないため、 
ユーザーが行わなければなりません。ここで®要なことは、レジスタに方き込まれた値は、 
riim にメモリに a&E されレジスタの«を要求されたときには、この紀抵されているメモリ 
の値を返し、決してメモリマッハ•一のレジスタを直接; s み出すことはしないということです< 

したがって' 例えば r PUT_Plj によってセグメントをイネーブルし、 r GETJ>lj をコー 

ルすると变瞭に？ fS 込んだ to が：® されます。 マッパーレジスタを在«統み込んだ場合には、 
セグメント sy- のうち必要でない上位ビットは通常記»されないため，方き込んだ値とは與 
なる姐が返される能性があります， 

また、システムに抱 ft のマッパーレジスタが#在しているときに，ハードウ xT ■の#{合に 
よ〇热觔作する可能性があります。ですから、ユーザーは必ずこれらのル_チンを使 w して 
メモリマッパーを雄作しなければなりません， 

r PUT.P3j ル—チンは提供されていますが、•夫 MS にはダミールーチンで、ページ3のレ 
ジスタは®史されません.これは、ページ3のレジスタの内 W を絶対に変 K してはならない 
ためです。ただし r CETJ , 3j ルーチンでぺージ3にどのセグメントがあるかを判断すると 
とはできます。 

もう1組のルーチン （「GETPHj と rpUT^Hj) は栈能的には同じですが、ページを H 
レジスタの上位2ビットで指定します。これは、 HL レジスタがアドレスを持っているとき 
に "ft •用です。これらのルーチンは HL レジスタを破壤しません a rpUTPHj はページ3の 
レジスタを変史しません， 
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PUT. Pii n=0. 1, 2. 3ページの逸択 

パラメータ A= セグメント根号 
結栗 なし 

すべてのレジスタが保#される 

GET.Pi! u=0、 1、2、3ぺージの*択 
パラメ—夕なし 
結果 A= セグメント番号 

すべての他のレジスタは保存される 

PUT_PH 

パラメータ H= アドレスの M4 パイト 
A= セグメント番号 
結采 なし 

すべてのレジスタが UE# される 

GETJH 

ハ•ラメータ H= アドレスの上位バイト 
結果 A= セグメント*号 

すべての他のレジスタは保存される 

これらのダイレクトページングルーチンを使用してページングの状想を变思する lW に，プ 
〇グラムでは、まず r GEXPnj を使用して、セグメントの初期状®を«存しておいて下さ 
い（あとでそのセグメントを元に庚すため) • セグメントの初期状®はシステムの将來のパー 
ジョンでは変 K される可能性があるので、プログラムでは、これらに W 定した値を仮定して 
はなりません。 





祈しい MSX-DOS27 ァンク •〆* ン I40HKI 上のファンクシ 3 ンコール）は•■エラーコー 
ド J を A レジスタに S します《飪理が成功するとゼ〇になります • ゼロでない場合，エラー 
3— ドはXラーの棰頸を示します。 

MSX DOS2U ファンクシ*ンコールからりターンする两前に r 0R Aj 命令を実行するた 
め、エラーが起こったかどうかテストするためには.外部ブ a グラムの 「CALL5j 命令の 
ifl： 後に r JRNZj 命令を使用します，このエラージャンブの»ぴ先では通# B レジスタにエ 
ラー3 — |••を口ードして、 1 •エラー:!ードを返して終了 j フ7■ンクシ9ン （R320 参照）を実 
行します。これはエラーコードをコマンドインタープリタに返し、そこで適当なメッセージ 
が表示されます。 

外部ブ〇グラムは MSX-D0S2 のファンクシ*ンコールで®されたすべてのエラ—につい 
て、「エラーコードの！!I用 j ファンクシ3ン （P.323 参照）を利用して自分自身で実際のメッ 
セージを得ることもできます，詳細については17.3 r 77 ■ンクシ a ンの说明 j を参照して F 
さい. 

エラー3-ド U0FFH で始まり、鐮が下がってきます • 40H 未*の筐はI■ユーザエラ ーj 
で、システムでは使川されず、外3ブログラムがのエラーを返すために使用することが 
できます，コマンドインターブリタに返された 20H 来滿のユーザエラーはメッセージを出力 
しません， 

广エラーコードの説明 j フ7■ンクシ3ンコールがメッセージを持たないエラーコードを说明 
するように要求された場合、返される文字列は r Systemerror <n>j 「システムエラー < n >j 
または r User error <n>j 1 ■ユーザエラー <n>j です。 ここで <n> はエラー番％を示します。 

以下に現在定装されているすべてのエラー番号とそのメッセージおよび意味を示します • 
また二ーモニックも示？れますが，これは通常ソースファイル中のシンボルとして使用され 
特定のエラー#参照するために MSX-D0S2 のシステム全体を通して使用しているものです， 





16.1 ディスクェラー 


このグル_プのエラーはデイスクエラー «ja ルーチンに政されるものです。デフオルトで 
は ■> r 中止、再试行 j エラーとして報 ft されます • これらのエラー u 1 ■ディスクのフォーマッ 
卜 J 以外の MSX DOS フ r ンクシ3ン3—ルでは、エラー》1瑰ルーチンに渡されますので， 
BDOS からの W り ifit しては返されません， 


表 2.2(1 ディスクエラーー K 

二ー モ ニ-/ 英 JS エラーメ 7セージ II冬路エラー'/セージ 

ク 

.NCOMP Incompatible disk ^ —二の y ィスク tt 使用 T# * せん 

そのドライプではディスクがアクセスできません（例えば片面ドライブで两 
isi ディスクを a もうとしたと s>. 

害#込み異常です 

ディスクが異常です 


OFCH .NRDY Not ready 


ディスクが入っていません 


.VERFY Verify error 正 L 《害#込まれませんて 

た 

VERIFY が有効のとき、古き込みの後にセクタが正しくあめませんでした， 


OFAH .DATA Data error ディスクのデータが異常です 

CRC エラーチェックが不正なためディスクセクタが読めませんでした„通常 
ディスクの ffl 傷を表します • CRC は、ディスクの*み取リエラーを検出す 
るために，データと 一# にディスクセクタに？{仕込まれます。この CRCK 
よリディスクからデータが正しく菝み取れたかを典べるのが， CRC エラー 
チェックです a 
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エラー ニーモニノ 美；# エラーメノセー -〆 H*iSi ラー 〆 /セー シ 

3-ド ク 

0F9H RNF Sector not found セクターが見つかりません 

要求されたセクタがディスク上で見つかいませんでした，通常ディスタの«1 
m を表します。 

0F8H •'WPROT Write protected disk ディスクが害#込み保31され 

てぃます 

卉き込み禁止驮想のディXクに SS 込もうとしました • 

OFTH .UFORM Unformatted disk ディスクがフォーマットされて 

ぃません 

ディスクがマ*— マッ トされてぃなぃ，あるぃは又なった ae 餘方 ii を使用し 
てぃます。 

0F6H .NDOS Not a DOS disk MSX-DOS ディスクではあ 

リません 

ディスクが別のオペレーティングシステム用に7ォーマットされており、 
MSX DO ではアクセスできません。 

0F5H WDISK Wrongdisk ディスクが 遘 ぃます 

MSX-DOS がアクセスしてぃる a 巾に別のディスクに交換されまし/二 il； 
しぃディスクに交換しなければなりません。 

0F4H .WFILE Wrong disk for flle この 77 イル用のディスクでは 

ありません 

才-■プンされたフ T イルがディスクト.にあるときに*！)のディスクに交換され 
ました。 ih しぃディスクに交換しなければなりません。 

0F3H SEEK Seek errror シークエラーです 

ディスクの要求されたトラックが兄つか0ませんでした， 

0F2H JFAT Badflle allocation table FAT 異常です 

ディスク上のファイルアロケーシ 3 ンテープルが破壞されてぃます。 CHKDSK 
でディスク.ヒのデタのぃくつかを®话することができる場合があります， 



第16章エラー 




エラー ニーモニ/ 英エラー〆/セージ II本讲エラー/./セージ 

コード ク 

0F1H NOUPB 

このエラーはディスク交換®:理の一部として MSX-DOS 内部で常にトラノ 
ブされユーザーに»ることはないため、メッセージを持ちません。 

OFOH IFORM Cannot format this drive このドライプはフオーマットで 

きません 

フォーマノトできないドライプをフォーマ •/ 卜しようとしました。通常 RAM 
ディスクをフォーマツトしようとして起こります。 


16.2 MSX — DOS フアンクシヨンエラー 

以下のエラーは4常 MSX DOS のフ r ンクシ a ンコールで返されるものです。特定の MSX 
DOS のフアンクシヨンから返されるエラーの弃細については 17.3 1 ■フ r ンクン3ンの; ti 叫 j 
を#照して KS 


衣 2.21 MSX-DOS フ T ンクシ3ンェラ- U 


エラー ニーモニ v 英语エラーメッセージ II本语エラー/ セージ 

コード ク 

ODFH .INTER Internal error DOS が異常です 

起こってはならないエラー。 

ODEH >NORAM Not enough memory メモリ—足です 

MSX-DOS がその 16K のカーネルデータセグメントでメモリを使いつくし 
ました。セクタパッフ7•数を滅らすか、いくつかの谋％«»を削除して下さ 
い • RAM ディスクを作成するための太-使用セグメントがない«合にも起こ 
ります。 

ODCH .IBDOS Invalid MSX-DOS call 無効な MSX-DOS ファンク 

シヨン番号です 

MSX-DOS のコールが不止なファンクン3ン番号で行われました。大部分 
のイ、正な7 T ■ンクシ 3 コールはエラーを返しませんが，このエラーは r 3 ■前 
のエラー3— ドの®得 ■! フアンクン3ンコール （P.249 参照）が支行される 
と返される場合があります， 
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エラ'' 二ーモ： •/ jys エラー〆/セ—ジ u 本3#エラーメッセージ 

コード ク 

ODBH .IDRV Invalid drive 無効なドライプ名です 

ドライプ番号のパラメータ.あるいは(••ライプ•ハ•ス • フ T イル文字列中の 
ドライプ文字が現在のシステムで#在しません， 

ODAH .IFNM Invalid lilename 不正なファイル名です 

7 r イル*文字列が不止です。これは，ドライブ•パス•ファイル文字列で 
はなく、純粋なファル名文字列についてのみ生成されます， 

0D9H .IPATH Invalidpathname 無効なパス名です 

ASCIIZ ドライブ•パス•フ T イル文字列が液されるすべてのフ 7 •ンクシ 3 
ン 3 —ルによって返される可能件があります。文字列の構文がなんらかの形 
で不'正であることを示します。 

0D8H .PLONG Pathname too long パス名か•長通 J •ます 

ASCIIZ ドライブ•パス•フ 7 •イル文字列が拽されるすべてのフアンクシ 3 
ン 3 _ル 1= よって返される可能性があります。指定された完全なパス（使用 
3れている場合•にはカレントディレクトリも金む）が63文字よりも长い i 
とを示します- 

0D7H .NOFIL File not found ファイルが見つかりません 

ディスク h のファイルを検索するすべてのファンクシ*ンによって、ファイル 
が見つからなかった場合に返されます。このエラーはディレクトリが招定さ 
れ、それが見つからなかったにも*されます-それ以外では次の. NODIR 
エラーが返されます。 

0D6H .NODIR Directory not found ディレクトリが見つかりません 

ドライブ•パス•フ 7 ■イル文字列中の途中のディレクトリが見つからなかっ 
た％合に返されます- 




です 


新しいエントリがルートデイレクトり中で要求され、それがすでにいっぱい 
てある場合•に、 r 作成 j あるいは r 移抑」のファンクションによって返され 
ます，ルートディレクトリは桩®できません。 

0D4H .DKFUL niak full ディスクがいっぱいです 

杏き込まれようとしているデータの S に対してデイスク上に十分な領域がな 
い場合に、5き込み ft 理によって返されます。ディスクが一杯の場合にサブ 
デイレクトリを作成あるいは拡强しよつとした場合にも起こります。 

0D3H .DUPF Duplicate filename ファイル名が霣愎しています 

H 的のファイル名がすでに H 的のディレクトリ中にある場合、 1 ■名前の SKj 
あるいは 1 ■移 Wj ファンクションて•起こります。 

0D2H .DIRE Invalid directorymove ディレクトリか" 8® できません 

サブディレクトりをそれ0体の下に移動しようとしました，これはデイレク 
トリ構造中で孤立したルーブを作成;することになるため許されません。 

0D1H .FILRO Readonly file ファイルが班み出し專用です 

「故み出し琢用_! K 性ビットがセットされている7ァイルにき込みあるい 
は削除しようとしました。 

ODOH .DIRNE Directory not empty ディレクトリが空ではありま 

せん 

空でないサブディレクトリを削除しようとしました。 

OCFH .IATTR Invalid attributes 無効な S 性です 

フ T イルの«性を不正な方法で突®しようとしたか、あるいはサブディレク 
トリに対してのみ可能な tt: 理をフ T イルに行おうとした場合に起こります。 
また，ポリューム名の FIB (File InfoimationBlock) の不 it な使用によっ 
ても起こります。 
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エラーニーモユヴ夹語エラ—メ /セ—シ II本通エラーメ Vセージ 

3-K 9 

(1CEH .DOT Invalid or .. operation .や.. l 二対して ttS 作で？ませ 

ん 

サブデイレクトり中の r .j あるいは r ..j ェントリに対して、名«!|の变更や 
移動などといった不正な»作をしようとしました， 

OCDH .SYSX System fileexbts システム7ァイルが成にあり 

ます 

庥存の>•ステムファイルとおなじのファイルあるいはサブデイレクトり 
を作成しようとしました，ンステムファイルは自 W 的には M 除されません. 

OCCH .DIRX Directory exists デイレクトリが R にあります 

既存のサプディレクトリとおなじ名 ii5 のファイルあるいはサブディレクトリ 1 
を作成しようとしました。サブディレクトリは勳的には Bij 除されません。 

OCBH .FILEX File exbtx 7ァイルが R にあります 

既存のフ 7 ■イルとおなじ名曲のサブディレクトリを作成しようとしました， 

フ7■イルはサブデイレクトりを作成するときに UB 抑的には削除されません. 

OCAH .POPEN File is already in use フ7イルが使用中です 

そのファイルに対してすでに才—プンされている7ァイルハント•ルがある 
ファイルの削徐，名前の*®、移動，あるいはその«性や B 付や時 M の! KK 
を-そのファイルハンドルを tt 用せずに行おうとしました， 

0C9H J0V64K Cannnot transfer above 64 K 64K を越える転送はで# ませ 

ん 

ディスク転送が OFFFFH を超えてしまいます. 

0C8H FILE Fileallocation errror 77イルの割当異常です 

ファイルのクラスタチIインか破壤されました， CHKDSK を使用して可 K 
な®リファイルを後活させる必«があります， 

0C7H .EOF End of file ファイルの終わり T す 

ファイルボインタがすでにェント•オフ■ファイルにある、あるいはそれを超え 
ている坶会に.さらにファイルから政み込もうとしました， 
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エラー ■/ 英 iS エラー〆/セージ n 木, ifl エラーメ ./ セージ 

3—ト ク 

0 C6H .ACCV File access violation ファイルァクセス II 常て'す 

適切なァクセスビットをセ，/卜してオープンされたファイルハンドルに対し 
て3{み «•, し-塞き込みを行おっとしました。1£»フ7■イルハンドルのいくっ 
かは出し#用あるいは*き込み#坩モードでオーブンされています， 

0 C 5 H .IPHOC Invalid process id 齄効なプロセス ID です 

r «l プロセスに戻る j フ T ンクシ3ン （ P .318 麥照）に*3れたブロセス II ) 
が不 it です • 

0 C 4 H .NHAND No spare file handles 77 イルハント*ルが足りません 

すべてのフ T イルハンドルがすでに使用中である場合にフ7■イルハンドルを 
オープンあるいは作成しようとしました。現パージ3ンでは64までフ7•イ 
ルハンドルが利用できます， 

0 C 3 H JHAND Inval id file handle 無効なファイルハンドルです 

指定のファイルハンドルが，システムで？ r される最大のファイルハンドル* 
y •よりも大きいです。 

0 C 2 H .NOPEN File handle not open ファイルハンドルが才ープン 

されていません 

指定のフ T イルハンドルは現在オープンされていません。 

0 C 1 H JDKV Invalid device operation 無効なデパイスオペレ—シ a ン 

T す 

デバイスのファイルハンドルや F1B を、検索や移動などの不] T な作に使 
H1 しようとしました。 

OCOH .IENV Invalid environment string 無効な環境変数です 

環境変数名の文字《に不 ] T な文字があります。 

OBFH .ELONG Environment string too long 環境変数が長遇ぎます 

83堆変数名あるいはその始_の文卞勿1が M 大の255文字の長さを超えた，あ 
るいは fc すぎてユーザーバッファが足りません • 
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エラー ニーモニ/ 英語エラー〆ノセージ II本 nft エラーメ v セージ 

ノート —ク 

OBEH .IDATE Invalid date 無効な日付けです 

r a 付のセ7卜 J に®された H 付のラメータが不 (E です， 

OBDH .1TIME Invalid time 薷効な時Xです 

r Bl •刻のセット J に®された時刻のハ•ラメ--夕が不正です。 

OBCH .RAMDX RAMdisk(drivcH:) already RAM DISK (ドライプ H : ) 
exists ttttU あります 

RAM ディスクがすでに存在しているのに RAM デ■(スタを作成しようとし 
た場 <V,『RAM ディスク j ファンクンヨン （P.326 •參 S8) から返されます， 

OBBH .NRAMD HAM disk does not exist RAM DISK がありません 

RAM ディスクが存在していないときに、77■ンクシ3ンで KAM ディスク 
を制除しようとしました，存 fr しない RAM デ■(スクをアクセスしようとす 
るファンクンヨンでは、 .IDRV エラーとなります 0 

OBAH .HDEAD File handle has been deleted ファイルが消去されています 

ファイルハンドルに网：®した7ァイルが削除されたため、77•イルハンドル 
はもう使用できません。 

OBOH .EOL 

起こってはならない内部エラー。 

0B8H .ISBFN Invalid sub function number 無効なサプファンクシ，ン番号 
です 

•■デハ*イX1/0の M5 Wj 7 r ンクン a ン （P.3025«> に孜されたサブ 7 t 
ンクシ■ン番号-が不 it です， 

0B7H .IFCB Invalid File Control Bolck 無効な FCB です 

FCB を使ったファイルアクセスの除. JOPEN などを3_ルせずに、 n 効 
な FCB を使用して泣み ft きした際に起きるエラーです。 



16.3 プログラム終了エラー 

KH ••のエラーはシステムによって内部的に1成され、「中断 j ルーチンに«され6エラーで 
す。これは常フ t ンクシ s ンコールからはあされません，中断ル ー p には外 a ブログラ 
ムが「エラーコート-を返して終了 J フ r ンクシ s ンコール （P. 320#照 > に®す ft ■怠のエラー 
が*されることに H.S して下さい， 

表2 22プ〇グラム終了エラーー« 

エラー ニー t ニッ 5US エラーメッセ-•ジ II 本 iS エラーメメセーシ 

3-ド ク 

09FH STOP Ctrl-STOP pressed CtrJ-STOP が押されました 

(CTRL1 + fSTOPl キ-は,すべての文卞 1/ 攀などのほとんどのシステム 
コールでチ i ックされます。 

09EH .CTRLC Ctrl-C pressed Ctrl-C が押されました 

[CTRL].. [Cjg. ステータスチ无ックを*行する文字フ7•ンクシ3ンの坳 
合にのみ層Iックされます。 



16.4コマンI■•エラー 




エラー ニーモユ/ 炎 JS エラーメソセージ II本エラーメッセージ 

コ-ドク _ 

09BH .INERR Error on standard input 標準入力でエラーが起#まし 

た 

入カチャンネルが文字77•ンクシ3 ✓ (7 ァンクシ3ン 01H-0BH) を 
通してアクセスされている W に、エラーが起こった■に返されます。 n<n 
エラー: j — ドは2次エラーコードとして B レジスタに入れられてアボート 
ルーチンに®されます。 ft も起こり得るエラーは 「.EOFj エラーです。こ 
のエラ*-は通常、ブログラムが榑准7 r イルハンドルを变 K している場介に 
の AIS こります。 


16.4 コマンドエラー 

以 F のエラーは MSX-DOS のフ7■ンクシ a ンコ-■ルからは iii されませんが、コマンドイ 
ンターブリタによって使用されます，これらは外部ブ〇グラムから利 HI できますので、ここ 
にのせてあリます s 9在•■エラーおよびメッセージ j ではコマンドインタープリタでこれらの 
エラーが持つ.£味の订細が SC 述されています • 

表 2.23 コマンドエラ ー--6 


エラー ニーモユ v 关讲エラーメ>»セージ n 本エラーメ》セ — ジ 

3-K ク 

08FH .BADCOMWrong version of command コマンドのパ■ジ a ンが遵い 
ます 

COMMAND2.COM がディスクからその#常»部分をロードしたが、その 
チ*ヴクサムが期待通りの ft ではありません 0 

08EH .BADCM Unrecognized command コマンドが違います 

指定の：3マンドが内部コマンドでなく、その名前の .COM および. BAT フ T 
イルも见つかりませんでした， 

08OH .BUFUL Command too long コマンドが長すぎます 

パッチフ7•イル中のコマンドが127文宇の E さを組えています • 
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エ ラー ニーモニ,英„菩エラーメ /セージ II本通エラーメ？セージ 


08CH .OKCMD 

COM.\l;\ND2.COM にコマンド行で渡したコマンドが柊 T した®に返され 
る内部エラー：ド < この x ラーコードにはメッセージがあ*)ません >• 

U8BH .IPARM Invalid parameter 鰲効なパラメータです 

コマンドへのパラメータが，なんらかの形で不止です。例えぱ範拥外の攻恤 
であるなど， 

08AH .INP Too tnanyparameters パラメータが多すぎます 

3マンドが®求するすべてのバラメ_夕を解析した後で、コマンド行上.にま 
だ SW リ文すでない文字が伐っています。 

089H .NOPAR Missing parameter パラメ-夕が不足しています 

ハ•ラメータがあるべきところでエンドホプラインが ft つかりました- 

088H IOPT Invalidoption * 効なオプシ a ンです 

コマンド行で/の後に指定された文字はそのコマンドでは不 iE です。 

087H -BADNO Invalid number 着効な tt 值です 

数値が求められているところに，数字以外の文字が入っています。 

086H .NOHELPF.de for HELP not found HELP フアイルが見つかりま 

せん 

ヘルブフ r イルが足つからなかった.あるいはパラメータが有効な HELP 
ラメータではありませんでした。 

085H BADVERWrongversion ofMSX-DOS MSX-DOS のバ•ジ憑ンが 
違います 

このエラーはコマンドインタープリタで使用されることはありません《 3 
マン P インターブリタでこのエラーが発生した場合は自分自身で持ってい 
るメッセージを使 m します，しかし、このエラーを返すことが有用な場合に 
は、外»ブログラムで使 mt ることができます。 



164 コマンドエラー 261 

エラー ニーモニ* 突; Uj ラー〆/セーシ n 丰嬝エラーメ，セージ 

084 H NOCAT Cannot concatenatedestina - 後写先ファイルは結合できま 

tion file せん 

CONCAT コマンドの H 的のファイルがソースの柑定1=•一致しています • 

083 H BADEST Cannot create destination ファイルを作成できません 
Hie 

COPY コマンドで H 的のフ7■イルが作成される fc , ソ_スファイルのひと 
つ（あるいはすでに使用中の別のフ T イル）を®ね卉きしてしまいます。 

082 H COPY File cannot be copied onto 自分自身にはコビーできませ 

itself ん 

COPY コマンドで Hft ■りのフ T イルが作成5れるとソ ー X ファイルを* Ja # 

きしてしまいます。 





行章 

フアンクシヨンコール 


この車-では MSX-D0S2 の7ァンクシ3ンコールにつV、て样しく解说しています。7ァイ 
ルハンドル、ファイル情報ブロック (FIB FUe Information Block) >環境変数などといっ 
たンステムの特费:について槪 m している13$•■ディスクファイルの供; Sj とともに K むこと 
をおすすめします0 

MSXTKMSX-DOSkDiskBASIC という異なる現境でディスクを使用するので、 MSX- 
DOS のファンクシ a ンコールを実行するには2つの方法があ!）ます。 MSX-DOS の R 境で 
•美行される外部プ〇グラムは、 “CALL0005H” でファンクン s ンを利用しなければな9ませ 
ん， Disk-BASIC や0趾-8入810の環境で実行される他の》48父ブ〇グラム（通* ROM か 
ら実行される）では、 -CALL0F37DH” を通してファンクシ3ンを利用します。 

F37Dh を通してシステムを 3- ルするときには、特にエラーハンドリングやアボートルー 
チンを実行する場合に、 いくつかの制限があります， i /こ、 (DISK BASIC の場合のように） 
マスタ_ディスク ROM 中にない限•)、ページ1にあるノ《ラメータを*すことはできません • 
なぜなら、このよつなファンクシ a ンコールが実行されている問はマスタ-'ディスク ROM 
がべージ1に进択されているためです。 

特定のフアンクシ a ンについては、個々のフアンク-〆 a ンの垅明で相遑点が明 K してあり 
ます C 


17.1 フアン クシ ヨンコールの 方法 

MSX DOS のフアンクシ3ン：》—ルは C レジスタにフアンクシ a ンコードを、他のレジ 
スタ （A、BC、DE および HL> に必要なパラメータを人れ、 r(:ALL5j 命令を実行するこ 
とによって行います，鈇果はそれぞれレジスタ中に返されます • 

すべてのレジスタ (AF. BC、DE および HL> は MSX DOS のコールによって破!*され 
るか、あるいは«:采を返します 0 袅 レジスタセット （AF，、BC'、DE’ および HL0 は常に保 
#され、インデックスレジスタ（IXと IY) は、これらが結果を返す場合を除いて保存され 
ます。 

MSX DOS はコールされると内部スタックに切リ換えるため、必要な外部ブログラムのス 
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タノク«8パイトだけです。 

CP/M との互換性のため、 CP/M のファンクシ3ンに対応するすべて MSX-DOS のファ 
ンクションは， A=L および B=H でリターンします。多くの場合、 A はゼロで成功を示し 
01H あるいは OFFH で失敗を示すようなエラーフラグを返します。 

斩しい MSX-DOS のファンクション （40H 以上のフ7•ンクションコ-ドのもの）はエラー 
コードを A に.他の結果を別のレジスタ中に人れてリターンします。〇のエラ.ーコードは工 
ラーなしを示し、コートがゼロでない場合 ti、 なんらかのエラーが発生したことを示し、正 
確な妝因はその to を期べることでつきとめることができます。エラーコードおよぴメ y セー 
ジのリストは9¢で ill 明します。また、 MSX DOS では•■エラーコードの说明 j 7T ンクシ3 
ン （P323 参照）が filRS れていて、エラーコードについての说明文字列を与•えます， 


17.2 ファンクシヨンー覧 

以下にファンクシ3ンコールの全りストを示します， 

「ファンクション」には、フ7•ンクシ S ンの番号と梭能を示します。 
r CP/M 互換 j に r Oj と纪されているファンクシ9ンは、 CP/M2.2 のファンクシ3ン 
と互換 1$. があることを S 味します。 

HD0S1E 换 j に r Oj と記されているフ T ンクシ9ンは、 MSX-D0S1 と互換彳生があるこ 
とを S 味し、それ以外のファンクシ a ンは， MSX D0S2 で新たに追加されたファンクショ 
ンであることを想味します， 

「エラー*!理 j に rQj のついたフ r ンクシ3ンは、ユーザ_のディスクエラ—®理ルー 
チン（ファンクシ s ン 64H およびファンクン s ン 70H 参照）からコールできることを*味 
しま1% 

1 ■ページ j には、ファンクン s ンの解说をしているページを示します。 
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在2.24 MSX-DOS2 ファンクシ3ンコールー 1 E 




U0U フ•ログラムの終 f 

01 H 3〆、ノール入力 

02H 3ンソール出力 

03H 補助入力 

04H 捕助出力 

05H ブリンタ出力 

06H 苗接コンソール I/O 

07H |肓接コンソール八力 

0RH エコーなしコンソール入力 

09H 文字列出力 

0AH バッファ行人力 

0BH 3ンソールステータス 

0CH パージョン*号の®得 

0DH ディスクリセット 

0EH ディスクの遵択 

0FH フ7•イルのオープン [FCB】 

10H フ7•イルのクローズ [FCBj 
11H 败初のエントリの検索 [FCB] 
12H 次のエントリの検索 [FCB] 

13H フ7•イルの削除 [FCB) 

14H シーケンシャル说み出し [FCB) 
15H シーケンシャル» $込み [FCB) 
16H フ7•イルの作成 [FCB] 

17H ファイル名の変® [FCB) 

18H ログインベクタの樓得 
I9H »レントドライブの推得 
1AH ディスク転送アドレスのセット 
1BH アロケーション情報の®得 


CP/M DOS1 

互換 互換 


〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 
〇 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 


エラー 
_热理 


〇 

〇 

〇 

〇 

〇 

〇 

〇 

〇 

〇 

〇 

〇 

〇 


〇 

〇 




•xo 

269 

270 

270 

271 
271 

271 

272 

272 

273 

273 

274 

274 

275 
275 
275 
277 

277 

278 

279 

279 
2S0 

280 
281 
281 
282 
282 
282 
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21H ランダム忒み fll し [FCBj 
22 H ランダム序き込み [FCBj 
23H 7 7•イルサイズの播得 (FCB] 

24H ランダムレコードのセ •/ 卜 [FCB1 
26H ランダムプ〇ック齐き込み [FCB1 
27H ランダムブロック攻み出し [FCB! 

28H ゼ〇フイルを打うランダム*き込み 
[FCB] 

2AH 口付の播59 
2BH 卩付のセット 
2CH 昤刻の®得 
2DH 時刻のセット 

2EH ベリ7ァイフラグのセット•リセット 
2FH アプソリュートなセクタの班み出し 
30H アブソリュートなセクタの'#き込み 
31H デイスクバラメータの播竹 
40H tt 初のエントリの検索 
41H 次のエントリの検索 
42H 斬しいエントリの検索 
43H 77•イルハンドルの才—ブン 
44H フ T イルハンドルの作成 
45H 7ァイルハンドルのクローズ 
46H 7T イ ルハンドルの確 1S 
47H ファイルハンドルの複製 
48H 77•イルハンドルからの嫌み出し 

49 H 77■イルハンドルへの耆き込み 
4AH 7T イルハンドルボインタの移觔 
4BH デパイスの I/O 制 W 
4CH 7アイルハンドルの検査 
4DH フ T イルあるいはサブデイレクト _J の削 
眈 

4EH ファイル？ 1 ;あるい <i サブデイレクト U 名 


CP/M DOS1 
互換 互換 

〇 〇 

〇 〇 

〇 〇 

〇 〇 

〇 
〇 

〇 〇 

〇 

0 

〇 

〇 

〇 

〇 


〇 

〇 

〇 

〇 

〇 

〇 

〇 

〇 


4FH ファイルあるいはサブデイレクトリの移 

姑 


ぺージ 

2S3 

283 

284 

284 

285 

286 
286 

287 

287 


288 

288 

289 

289 

290 
2§0 


3 舻 


293 

"29T 


296 




フ T 


55H フ 7* イルメ 
S6H 

得•セッ 
57H デイス 
58H ぺ•け. 
59H カレン 
5AH カレン 
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17.3 ファンクションの説明 

以ドに MSX-DOS のファンクシ s ンのそれぞれについて、古いもの、斩しいものを含め 
て洋しく说明します0 7ァンク y ョン#^の f 金のかっこ中の名前は r CODES.MACj 中で定 
在されているファ〆クシ3ンコードのパブリ7ク • ラベルです。ブ〇グラムではこれらの名 
w を可能な-限リ使川しなければなりません。 

40H 未1»のファンクン a ンの多くはエラーコードではなくエラー7ラグを返します。エラー 
フ ラグがセッ 卜されると、エラーの原闪を示す实際のエラー3— ドは r iE 前のエラーコード 
の後}! hi フ7■ンクシ9ン№.323参照）で得ることができます。 40H 以 h のすベてのファンク 
シ s ンは A レジスタ中にエラーコードを返します。16章 r エラ ーj では、 ファンク vs ンか 
ら返される一般的なエラーについて K 述しています。本章での俏々の77■ンクシ s ンの说明 
では、そのファンクシ s ン W ★•の+•なエラーの状想について記述します。 

ディスク上の愤相を* E する7 7■ンクシ9ンコールの多くは fl 觔的にテスクバッファを 
フラッシュしないため、デイXクはそのファンクション 3 —ル夹行後すぐには、必ずしも止 
しく E 新されないことに注意して下さい。このようなファンクシ 3 ンコ_ルにはすべての夕 
イブの「作成」、 1 ■方き込み_|、 1 •削除」，••名荊の变 Kj 、 r 7T •イル B 性の変 Ej 、 「ファイル 
の B 付と時刻の変史 J 7T ンクシ*ン3—ルが ft ■まれます。ディスクメ<ッフ r を常にフラ/ 
シュする77•ンクシ9ンは，「バッファのフラッンュ J、 •"ク〇— ズ J、 および 1 '? f. 保 J だけで 
す，これらの処理の後では，ディスクは常に it しく E 斯されています。 
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プログラムの終了 

I 棵能 S f' OOH(-TERMO) 


|cp/mJ [DOSl] 


この 7 アンクシヨン lio のり夕ーンコードでブ D グラムを終了させま 
す。これは MSX-DOS1 および CP/M との亙換性のために用 S されてお 
り、ブログラムを终 f するには、 r エラーコドを返して終了 j ファンク 
シ3ンコール （P.320 多照）を使 W することを推焚します。この場合で6 
必要ならエラーがなかったことを冰す〇のエラー:* -ドを®すことができ 
ます，ブログラムか'終了するときに起こることについての烊«はそのファ 
ンクシ*ンコールの a 明，および 12.2 rMSX-DOS へのリターン j を参用 
して下さい《このフアンクシヨンコ•■ルは呼び出し侧に戾ることはありま 


コンソール入力 Icp/mJ IdosiI |i7-«ia| 

I 捩能* 号1 01H(-CONIN) 

[コール手期]なし 

| ^ •) tib I レ A キーボードからの文字 

[ » 说] 文字が樣準人力 （77 •イルハンドル0 - 通常はキーボード）から雄み 

込まれ、摞準出力（フ T イルハ/ドル】通常はスクリーン）へエコーさ 
れます，文字がなければ、文字が入力されるまで持ちます。「コンゾール 
ステ—タス j 7ァンクシ3ン （P_274 多照）で播定されている様々なコント 
ロール文字は種々の制御のためにトラッブされます。この裡の文字が検知 
されると、趄理の後.別の文字を待ちます。したがって，このフ r ンクシ 3 
ンではその 3 ントロール文字はユーザーに返されることがありません。 



コンソール 出力 


ICP/MI I DOS! I |1ラー処理 I 


[梭能* 号] 02H(.CONOUT) 

[p- ル手順| E 出力する文字 
「民り 値] なし 

«_决| E レジスタに波された文字が tSHT 出力 （77 •イルハント•ル1通常ほ 

又クリーン）に！* F き出されます。ブリンタエコーが有効になっていると. 
文字はプリンタにも出力されます，杨々のコントロール3 — |••やエスケー 
プシーケンスは肉而制御コードとして解 K されます，これらの --K は14窣 
「幽而剽刺コート •_! に id« されており、樣咿の VT-523 ントロール:>ート- 
のサブセヴト K なっています， TAB は々ラム位 S が8の倍数になるまでス 
ペースに KM されて出力されます， 

コンソール入カステータスのチ*ックが行われ、「 3 ンソールステータ 
xj ファンクション < p _274 参. qn) で觯说された持別なコントロール文字が 
jji れた場合(4，そこで解说したように fea されます。それ以外の文字はそ 
の後の「コンソール入力 J フアンクシ3ンコールのために内部でセーブさ 
れます。 


補助 入力 [CP/Ml [DOSlI ’エラ-«4理 


03HUUXIN) 


なし 


L = A 人力文字 


文字が補助入カデバイス（ファイルハンドル3> から说み込まれ、文字 
がない場合には文字の入力を灯ちます。補肋人カデパイスはこの7アンク 
シ s ンが使用される莳にインストールされていなければなりません。デバ 
イスがインストールされていないとこの77•ンクシ9ンは常1=エンドオ 
ブファイル文•尹 rz ) を返します • 


[榱能番 y 

[コール手 W| 

[r *) » ] 
[w ] 
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補助出力 

[描能* 号] 04H(.AUXOUT) 
fa- •ル E 出力する文卞 
[_m *j ®] なし 

[解說丨 e レジスタに»された文字が捕肋 m カデバイス（ファイルハンドル 3) 

に共き出されます。袖肋出カデ八イ xli, このフアンクン3ンか使用され 
る前にインストールされていなければなリません。デパイスがインストー 
ルされていないと，このフアンクシ s ンは文 r を拾ててしまいます， 


プリンタ出力 [ c ^7 m 1 [ d ^ T ] 

I 機能 S ‘ぺ I 05 H (丄 STOUT ) 

I コール手)^] E 出力する文字 
[ S 5 *J ffi ] なし 

[W 说丨 E レジスタに渡された文字か校*プリンタデパイス <フ？■イルハンド 

ル4 •■通常はプリンタ）へ送られます。コンソ ー jJiLb " エ 

3—するおなじチャンネルが使用されます-このファンクション 
では TAB は KM されませんが、スタリーン出力が12553+ ®プリン 
夕にェ a ■•される t さには®期されます。 


直接コンソール I/O ICP / M ] [DOSf | エラ-*1理- 

[機能# 4 I OCH(.DIRIO) 

[コール手 Ittj E OOH-FEH 出力する文卞 

FFH 入力要求 

[« 'J ft] A=L \)1 

00H 文 f がない 

そうでない場合には入乃夂 T。 出力については未: £«• 


[CP/M] [DOS1 
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「W Ji I E=FFH の«合には，揉嫌•人力（ファイルハントル 0) からの文字人力 

が 3K ベられ、文字がないと 00H が返されます。文字があると、椋敢入力 

(ファイルハンドル0> かり31み ii まれ、エコーされず，またコントロール 
文 T についてのチ X ックもされすに A レジスタに返されます。 

F . *FFH の«介には、レジスタ E 屮の文すが TAB の KIW やブリンタエ 
コ•■されすに、樣电出力（フ7■イルハンドル 1) へ出力されます，ま 
た，このフ T ンク z 3ンではコンソールステータスのチェックは彳了われま 

せん，またこのファンク Z 3 ン〇体は TAB を拭 Sfe しませんが， VT -52 3 
ン|■ロールコー KUTAB の toife を含むため、スクリーン1•.での効果は R 
じです • 


直接コンソール入力 uosT ] 


[檐能番5•丨 07 H (- DIRIN ) 

「コール手*| なし 

[« 'J tel L -* 人力文字 


W 说| このファンクシ3ンは文•字がない場 ft ■に11文字の人幻を待つことを除 

いて，フアンクシ3ン 06 H の人力オブ• 〆 ，ンと PJ —です.フ7•ンクシ3ン 
06 H と同様、エコーやコントル文字のチ x . y クは彳 T われません。この 
フアンクン9ンは、このフアンクシ9ン番号を 「 I / O バイトの*得 j に使 
坩してい SCP / M との互換性はありません， 


エコーなしコンソール入力 HdosTI ( x^-feaj 

[檐能•冷 I 08H(JNNOE) 

Iコール手«1 なし 

[« '； «£丨 L=A 人力文字 

I解说丨 このファンクシ a ンは入力された文字が<5♦出力にエコーされない点を 

松いて，•■コンソー•ル人力 j フアンクシ 3 ン （P.269 参照）と同様てす。同 
様のコントロール文字のチ x ックが行われます，このフアンクシ3ンは，こ 
のフ r ンクシ3ン番号を 「I/O ハ•イトの S 定 j に使用している CP/M との 
互換性はありません。 
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文字列出力 cp/mj | dosi ] トラ-* aa— 

[檐能# 号 I 09H{^TROUT) 

[3 — ル手®; DE 文卞鑛のアドレス 
|戻リ値 I なし 

[解说丨 DE レジスタで衍される文7列の文字が通*の r コンソール出力 j 7r 

ンク ysi ン （P.270 参照）を使用して m 力されます • 文字列14 (ASCII 
24H) で终了します。 


バッファ行入力 ICP / M 1 [pOSl] 

「機能# ぢ_ I OAIl(JJUFIN) 

「コール手順 | de 人カパッフ r のアドレス 
[k 〇 mi なし 


解说 I DE は入力に ft 用5れるべきパプファを W していなければなりません。 

このパッ7 7•の W 初のパイトはパッフ7■が保持できる文 fR (0-25«を 
持っていなければなりません • 人力行は標取人わデバイス（フ r イルハン 
ドル0通常キーボード）から«み込まれ^バッファに格納されます•人 
力は CR が *8 準人力から嫌み込まれたときに終 T しま t。 入力された文字 
ぎ< (CRft 体は*まれない）は (DE+1) に格納されます。パヴ77■に余裕 
があれば、 CR が®後の文字の後に格納されます。 

キーボードから人力する坳合（通常の場合）、简妒な行エディタが利用 
でき、また、以前に人力された行の256パイトのリングパ"7 r があって、 
これを編1£した 1 )押入力したりすることができます•これらの te 東棱能に 
っいての W 細は2京「3マンド行の編生 j を参照して1•さい。入カパ-/ 7r 
がいっばいになると、バッファに入れられない文字がタイプされるなひに， 
コンソールのベルが I® リます，人力された文字は槙準出力に出力され、ブ 
りンタ X3 —が冇効になっている場合•は，ブり〆夕に t> 出力されます。 



コンソールステータス 


!CP/m| [dosi]& ラー Jttilj 


[ 檐能 * 号 '] OBH(-CONST) 

[コール手 JBj なし 

[戻り値 I L=A OOH 人力文字がない 
FFH 入力文字がある 

I解说] キーボードからの人力について、人力文字があるかどうかを示すフラグ 

が a レジスタに返されます。入力文 t があればそれが jaa 込まれ，特殊な 
コントロール文宇かどうか検2されます，そのようなロントロール文卞で 
ない坳合には，内»の1パイ！•八ッ 7r に tftW? れ、このファンクション 
への以降のコールでは、キーボードをチ*_/クしないで即座に r 入力文字 
がある j を返します。この77■ンクシヨンで「入力文字がある」と示され 
た場合、その文字はいずれかの 1 ■コン y- ル人で嫌むことができます。 

文字が r^Cj であると、ブ〇グラムはユーザーのアポー!'ル_チン（定 
«されている場分> を轻山して r.CTRLCj エラーを返して柊了します。 
文字が r~Pj であると、プリンタエコーが有効になり、 f-Nj の場 fs •に 
無上になります。文宇が r ~Sj であると、ルーチンは別の文宇が押される 
のを待ち、それから•■入力文字がない j という状!!|を•&すことによって 
イト j 機能を关保します。热《を*«行するためにタイプされた文字は 
無祝されますが， 「~Cj の場合にはプ〇グラムが ff 止します，これらと同 
様の入力のチェックは、 01H (P.269 参.明)、 02H (P.270 参照)、 08H (P.272 
魯照)、 09H (P.273 参.明.)、および OAH (P.273 参.照）でも実行されます， 


バージョンの獲得 [CP/M] [DOSlI [ _エラー処理 | 

[ 檐能番号 ] OCH(.CPMVER) 



ディスクリセット 


[CP/M] [DOS1] 


I 檐能番号 | ODH ( J ) SKRST ) 
p — ル. f Nfll なし 

[戻リ値 I なし 

[解说 I 内部バッファ中の，まだ？ f き出しが行われていないすベてのデータを 

ディスクに*き出します。 CP/M での* Rft •のように、ディスクの交換を-" r 
能にするためにこのフ r ンクン3ンを3—ルする必要はありません。ディ 
スク転送アドレスはまたこのファンクシ3ンによってその初期値 8GH に庚 
されます。また、デ7オルトドライプは A: となります， 


デイスクの選択 fcP/Mj IDOSlI 


I 機能番号 I OEH(.SELDSK) 

Iコール；啪： E ドライフ■番号 （0*A: 1»B: など） 

[K り®丨 レ*ドライブ数（1~8) 

「» 说| このフアンクシ3ンは指定の!'•ライプをデ7ォルトのドライブとして* 

択します，❖レントドライブは、 CP/M との ft 換 tl のため、0004 H 番地に 
も格納されます。使用できるドライプの数を A レジスタに返します，ただ 
し、ドライプ数に RAM ディスクは含みません。 


ファイルのオープン [ FCB ] DOST 

[楼能番 《•] tFH(JOPEN) 

Iコール手明] DE オーブンされていない FCB へのポインタ 

|戾り値1 L=A 0FFH ファイルが見っからない場合 
0 フ7■イルが見つかった場合 



ていな •! ナればなリません。指定した p ライプのカレントディレクト y で適 
含するフアイルが梭索され， a つかつた場合にはそれがオーブンされます. 
サブデイレクトリやシステム77•イルのエントリは無視され、フ7•イル名 
にワイルドカードを使用した墦合には®初の迪介するエントりがオープン 
されます。 


デバイス？;は（コロンなしで） FCB 中に s くことができ，その圾には 
デパイスをあたかもデイスクフ T イルであるかのようにアクセスすること 
ができます。«荦のデハイス名は 13.1 •■デバイXおよび文字 I/C)_J で定莪 
されています。 

エクステント (extent numher) のド14パイトはこのファンクシ3 
ンでは* K されず、ファイルはそれが析定された大きさをI•分保持してい 
る壜公にのみオーブンされます， -祕、 アブリケ—シ3ンプログラムでは 
このフ T ンクシ3ンを: J ールする《にエクステント黔号を0にセ.ノ I•しま 
す。エクステントの上位パイ Hi(J にセットされ^ CP/M との換件 
を確保しています。 

FCB 中の7ァイル名と■はデイレクトリエントリからオープンされ 
たファイルの実際の名前に茜き換えられます。これは通常は元のものと同 
一ですが、7イルドカ_ドを使ったファイル名やファイル名中に小文字を 
ft 用している場■には«なることもあります。 

レコードカウントは、1レコードあたり128ペイ（•として 7r イルのサ 
イズから叶霣したを，指定のエタステント中のレコードサイズにセット 

します。ファイルサイズのフイ—ルド、ボリューム ID、 およぴ8つの予約 

パイトもセツI•アヴブされます，々レン！•レコードおよびランダムレコー 
卜•のフィールドはこのファンク、 ✓ 3 ンでは 突 E されません。 St み出しある 
いは-;込みのファンクン a ンを使用する1«にそれらを枋期化するのはァ 
ブリケー:/3ンブログラムの rtfr となります。 

ファイルが兄つからない場合には，環境変 a「APPEND」 が; B ベられま 
す。これがセットされていると、フ r イルを梭索するべき2#目のデイレ 
クトリを指定するドライプ•パス文字列として解釈されます。描定のディ 
レクトリでファイルを検索し、 a つかった場合には前述のようにオーブン 
します。この場合、元の FCB のドライプパイトがデフ*ルト （0) であれ 
ば、止しく 77■イルがアクセスで S るようにドライブパイトをファイルが 
兄つかったドライプにセットしま1% 
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ファイルのクローズ [ FCB ] [CF/Mj DOS1J 

I 檐能 # 10H( FCLOSE) 

Iコール flftj DE オーブンされた FCB へのポインタ 

「戾り値： L-* OFFH 失敗した場合 
0 成功した坳介 

[解 ] FCB は OPEN または CKKATVT ンクシ3ンコールのどちらかを使っ 

てあらかじめオーブンされていなければなリません。ファイルが忒み出さ 
れただけであった場このフ T ンクシ 3 ンは何もしません。ファイルに 
并5■込みが iT われていた埸合には，バッファされていたナベてのデータが 
ディスク US き出され、ディレクトひのエントリが»切に®新されます。 

ファイルはクローズ後 t アクセスできるため、このファ〆クシ3ンは 
保」77•ンクシ3ンと间等なものと考えることができます。 


最初のエントリの検索 [ FCB ] [ct/mI [dosiJ 

[嫌 ttS 号1 llHt-SFIRST} 

ル手 ffij DE オーブンされていない FCB へのポインタ 

[Bi り ft j L-A OFFH ファイルが兄っからない埸合 
〇 ファイルが a っかった場合 

[ » 说1 このフ7■ンクシ a i*UFCB 中の柑定のドライプ （FCB のドライブ*ち- 

が 0 の場合はカレントドライブ）の*レントディレクトリで、 KCB 中の 
ファイル名と&張子に適 ft ■する7 T イルを検索しま1%ファイル名は 1 7イ 
ルド冷ードが使用でき （「?j 文字を含んでいる）、その垛合には«!初に適 
合するものが検索されます，エクステントフィールドのバイトか使用 
され、このエクステント番9を古むのに十分な大きさがあるフ7■イルのみ 
見つかります。通常、このフアンクシ3ンをコールする薊に、エクステン 
トフイールドをブログラムによって0にセットします 0 システムファイル 
およびサブディレクトリのエントリは検索されません， 

適合するものが見っかった場〇 (A=«). デ■{レクトリエントリ li DTA 
(ディスク転送アドレス）にコビーされ.荊にドライプ番号が•けられま 
す。こ<1は、 OPEN ファンクションコール TFCB として有接使用するこ 



とができます。エクステント sy- は検索する FCB の ！■ 位パイ1■の値にセノ 
卜され、レコードカウントは通切に初期 <匕されます (OPEN の場合と冏 
様)。デ■(レクトリエントりの W 性パイトは S1 パイトの位脔にスト 7* され 
ますが、それはその)の位 E (フ r イル名«乐了•フィールドの直後）が 
エクステントパイ（■のために使用されるか>5です。 

通合するものが見つからなかった場合 (A=OFFH), DTA は変更されま 
せん。いかなる場合 t、DE で指される FCB はまった < 変®されません。 
このファンクシ*ンはシステム内部で'必要な ff; 報を紀抵しており、>■次•のエ 
ントリの検索 j ファンクション （P.278# 照,> で検索を絞打することができ 
るため、「次のエントリの検索 j ファンクシ9ンを尖行する場分に FCB を 
保存しておく必要はありません， 

CP/M ではこのファンクシ3ンでドライプ#•が r ?j にセツトされて 
いると、すべてのディレクトリエントリ（別り； 1 i てられているものも解放 
されているものも）が通合します。また，エクステントフィールドが 「?j 
にセットされるとファイルのすべてのエクステントが迪合します。このよ 
うな楢能のどちらも、通常 CP/M のフ7•イルンステム恃冇の特殊な H 的 
の CP/M ブログラム（例えば 1 "STATj) でのみ使卬されます。どちらの 
拽盹 t 、 MSX DOS1 および MSX DOS2 には? 7- 丧しません， 


次のエントリの検索 [ FCB ] [ ctTmI - dosI ] 

[機能番分： 12H(_SNEXT) 

L コール手吡| なし 

[戻リ侦| L-A 0FFH ファイルが光つからない場合 
0 ファイルが見つかった場合 


「解说 1 このファンクシ*ンは 7T イル名に適合す6次のフ T イルの検索を統 

行します，返される結果は初のエントリの検 5feM と同一ですので、そ 
ちらの31明を#照して下さい，検索を枝行するために使 ra される情報は 
MSX DOS の内部で保持され、 r » 初のエントりの検索 j で使した元の 
FCB はなくてかまいません • このファンクシ s ン U r ® 初のエントリの検 
索」7ァンクシ3ンを关行した後でのみ teffl 可 Sg です。 
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ファイルの削除 [ FCB ] 


[CP/M i DOS11 


13H(-FDEL) 

DE オープンされていな U FCB へのポインタ 


[W 说 I FCB で指定したドライブのカレントディレクトリ中で FCB 中のワイ 

ルドカードを使用したフ r イル K に*分するすべてのフ7•イルか削除され 
ます。サブディレクトリ、システム77■イル、不ぐ" HI み出し#用フ T 
< ル UW 除されません。このフアンク-〆，ン UW らかのフ7■イルの (W 狳に 
成功した規合には、 A=0 として終 T します- A=FFH での終了はフ r イル 
がひとつ6削除されなかったことを示します。 


シーケンシャルな読み出し [ FCB ] (cp/mI [dosiJ 

I棰能# y .]14 H(.RDSEQ) 

Iコール7-啪！ DE オープンされた FCB へのポインタ 

[极リ诚1 W 01H エント•オブファイルでエラーの場介 
〇 砘み出しが成功した場合 


このフ7■ンクシ3ンは77•イルから次に技く128パイトのレ：！ードを;* 
み出し、現在のディスク転送ァドレス (DTA) に入れます。レコ—ドは現 
在のエクステント（上位および下位パイト）とカレントレコードによって 
指定3れます。レコードの 3S み出しに成功すると，このファンクションは 
々レントレコードを1つふやし、それが明 H に達したらそれを0に戾し 
て，エクステント番号を増やします。レコードカウントフィールド {) 必 
要ならば常に史新されます。 

MSX DOS では CP/M と« »なり、ファイルのサイズが128バイトの 
倍数である必要はないので，一部た f けうめられたレコードができることが 
あります。この場合、断片レコードはそれが外部ブログラムの DTA アド 
レスにコピーされると！;に«りが〇で a められます。 



シーケンシャルな書き込み [ FCB ] | cp / m | | dosi | 

[梭能》号] 15H(.WRSEQ) 

[コール手順！ DE オーブンされた FCB へのポインタ 

[块リー I L»A 01H ディスクか*一杯でエラーの場合 
0 塞き込みが成功した場合 


このファンクションは現在のディスク紜达アドレスから128パイトを 
ファイルに#き出します。レ： 1—K はカレントレコ'-ドおよぴエクステン 
卜によって指定されます。その後レコードおよびエクステントを適切に増 
やします • レコードカウントパイトは 7r イルが&银された場 ft 、 または» 
き込みが新しいエクステントに移助した場合，正しく®新されます。 FCB 
中の77■イルサイズも7アイルが扭 5ft されたときには更新されます。 


ファイルの作成 [ FCB ] 


[CP/Ml [DOS1] 



ファイル名の変更 [ FCB ] | cp / m | [ dosT ] 

[棵能* 号 I 17H(.FREN) 

[コール手順] DE 才ーブンされていない FCB へのホインタ 

0 11 ]L-A OFFH 火敗 
0 成功 


[W ai ! オーブンされていない FCB は通)({のドライプとファイル名、および 

(DE+17) から始まる2番 B のファイル名を持ちます。最初のファイル名 
に逋合する指定のドライプの冷レントデイレクトリ中のそれぞれのフアイ 
，レは 2»H のファイル名中にある 「? j 文字につぃては対応する文卞をも 
とのままにして，2番目のファイル名に史史されます，また、フ7•イル名 
の *15 や7、止な7ァイル名が作成されるのを防ぐため、チ*ヴクが行われ 
ます。サブデイレクトリやンステムファイル、不可視の名饷を* K するこ 
とはできません， 


ログインベクタの獲得 


[CP/MI [DOS1]p ラ-処理I 




カレントドライブの獲得 | cp / m | | dosi | 


[tt suit *J-1 

I コ -- f- Kfij 


19 H ( CURDRV ) 


なし 


L-A カレントドライブ （0 ■農：など） 

このフアンクシヨンは*レント K ライブの 8MJ •を返します， 


デイスク転送アドレスのセット |C_P/Mj fDOSl] 



[3 -ル.?-期 I 


lAll (- SETDTA ) 

DE 金求するディスク転送アドレス 


戻り® 


解说| このファンクシ3ンは DE に®されたアドレスをディスク faUL アドレス 

としてセットします。このアドレスはすべてのその後の FCB の統み出しお 
よび*き込みコールで使 MIS れ， 1*4 初のエントリの検索 [FCB|j (F.277# 
照 h 「次のエントりの検索 [FCB]j コール （P.27S 参照 > ではディレクトリ 
エントリをストアするために使用され、また r T ブソリ 1- ■卜なセクタの说 
み出い卉 S 込み j コール （P.28D、 290麥照> で使用されます。 MSX-DOS2 
で祈たに迫40された 「K み出し j および•■丼き込み j 7?•ンクンヨンでは 
使咁されません，アドレスは「ディXクリセット j 3-ル （P.275# 照）に 
よって 80H に庚されます。 


アロケーション情報の獲得 


[DOS1 1 



[解 ail1 このフ7■ンクシ3ンは指定のドライブ中のディスクについての榇々な怙 

報を返しまこのファンクション番号をア n ケージ 3 ンベクタのフ，ドレス 
を返すために使用している CP/M との互換性はありません • MSX-D0S1 
と3?なり、 FAT の最初のセクタだけが 1Y 中のアドレスからアクセスでき， 
そこのデータは次の MSX-DOS コールまでしか有効ではありません， 


ランダムな読み出し [FCB] f^T^] [ d 5 sT 1 


[檐能 » 号] 21H(.Jtl)RND) 

f コール -T •啪| DE 才ーブンされた FCB へのポインタ 

「り® | L-A 01H エンドオプファイルでエラーの坳合 
〇 a み出しが成功の場介 

[ W tt I このフ 7 •ンクシ 3 ンはファイルから 128 パイトのレコードを i 光み出して 

%在のディスク転送アドレス (DTA) に入れます，ファイルの位 gf は FCB 
の 3 パイトのランダムレコード#守 (2UI-23H) で i 欠まります。 CP/M 
と W なり、ランダムレコ-'ド*号の 3 パイトすべてが tt 用されます。ファ 
イルの柊わりにある断片レコードはユーザーの DTA K 3 ピーされる前に 
〇で訪められます。 


ランダムレコード番号は$31されないため、この7 了ンクシ a ンへの連 
統的なコールでは、外部ブログ9ムがランダムレコード# y ■を変更しない 
限リ间じレコードを K みます。削作用として、冷レントレ：！ードおよぴエ 
クステントはランダムレコード*号と冏じレコ—ドを参照するようにセツ 
トアップされます•つまり.迚絞的な a み出し（あるいは？ f き込み> をラ 
ンダムな说み出しの後で実行でき、その場合には冏じレコードから始まる 
ということです。レコ_ドカウントパイトもそのエクステントに対して正 
し<セットアップされます。 


ランダムな書き込み [FCB] 


[CP/M | [DOSl] 
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「解説| この77■ンクシ3ンは fJMF - のディスク fc ； 送アドレス （ DTA > から128パ 

イトのレコードをフ7•イルに方き込みます。去き込みは3パイ••のランダ 
ムレコード番号 (21 H -23 H ) で指定されるレコードの位 S に行われます， 
ランダムレコート•番 S } は3パイトすべてが使 HJ されます。レコードの仏 S 
が現在のエンドオブフ T イルを超えている場 ft 、 初期化3れていないディ 
スク免域がその拥を®めるために割り灼てられます。 

ランダムレコード*夸のフ ■( ールドは*£されませんが、カレントレコー 
ドおよぴエクステントのフイールドは ㈤ じレコードを参照するようにセツ 
トアップされます。レコードカウン！•バイトは，ファイルが扯强された場 
合、あるいは古き込みが析しいエクステントにまで及んだ場会には、必要 
に応じて凋まされます， 


ファイルサイズの獲得 [ FCB ] [ cp / m ] [uosi 

丨楼能# 号] 23H(.FSIZE) 

Iコール手順] DE 才ーブン3れていない FCB へのボインタ 

[戾リ tt 丨 L-A 0FFH 77■イルが見っからない場合 
0 7 7■イルが見つかった場{V 

I解说！ このフ7■ンクシ■ンは r 7 ァイルのオープン j (P.275 参 W) とまったく 

岡匕ように. FCB 中のファイル名に Ai 初に一致するものを挨*します。兄 
つかった77■イルのサイズは128パイト単位に切り上げられ、レコード数 
が決定されます。 FCB の3パイI•のランダムレコード姑«!がレ：!ー ド数に 
セットされるため、それは存在しない®初のレコ—ドの番号となります。 
ランダムレコード*岑の 4SH のパイトは変史されません • 


ランダムレコードのセット [ FCB ] [cpJm] idosT] 

1 搜能 S 号， 24H(.SETRND) 

[コール DE オープンされた FCB へのポインタ 
〔戻り値 1 なし 



ドをカレントレコードおよびエクステント番号によって決定されるレ 3 — 
ドに a 定します。ランダムレコード番号の4パイト b は変更されません。 
また、レコードがファイル巾に実際に frft するかどうかについてのチェ y 
クは行いません， 


ランダムなブロックの書き込み [ FCB ] 


IDOSXI 



7T イルの祝在のサイズより人きくても小さくてもかまわず，必耍(こ応じ 
てディスクの銥域が割り当てられた0解放されたりします。この方法で荆 
•) ヂ1てられた追加のディスク領域は、特定の憤に初期化されることはあり 
ません。 


ランダムなブロックの読み出し [ FCB ] 

[檐能® 弩丨 27H(JU)BLK) 

[コール手順| DE オーブンされた FCB へのポインタ 
HL 31み出すレコードれ 


A 01H エラー.通常エン！••オプフ r イル 
〇 成功 

HL 芡除に说んだレコード数 


jbosil 


「解； ft | この7?■ンクシ3ンは上 iC のブ〇ツクの雀き込みファンクシ s ンと対 

をなすものであり、その使用法もほとんど IrJ じです • この塌余も大きなプ 
d ックを a むと、通*の ci */ m の*I理よリもかなり速くなります。 

例えば、フ7■イルから 20K を说みたい場合、 1K ごとに20回の別々の 
フアンクシ3ンコールを行うより，11"1のフ7■ンクン a ン 3 — ルで 20K を 
K む方がよい方法と言えます。ただし 20K の嫌み込みをレコードサイズ 
1レコ'-ド々ウント 20K として fT うか，レコードサイズ 20K. レコード 
カウント1として行うか，あるいはその中明の任意の钳み合せて•行うかと 
いうことに两しては違いはありません， 

尖探に a んだレコードの e が hl に返されます。エンドオブフ7■イルに 
なった場合，（この場合' 断片レコート•になれば、ユーザーの DTA にコ 
ビーする菌に〇でうめられます）この数は要求されたレコードの软よりも 
小さいことがあります。ランダムレ 3-1 ••領域まれていない*初のレ 
コート•に修 it (つまり、 HL に也される値がそれに加算）されます. 


ゼロフイルを行うランダムな書き込み [ FCB ] 

[CP/Mj「DOS1 1 


28H(-WRZER) 


ール手！^ DE 才ーブンされた K® へのポインタ 
[埃り ffi ] L-* 01 H エラー 

〇 成功 


このフサンクションは r ラ/ダムな蒼#込み j ( P .283 参照）と M じです 
が、ファイルを拡银しなければならない場合に、データが力き込まれる前 
に析たに M リヂ|てられたすべてのデイスククラスタが0で攻められます。 


日付の獲得 


[DOSl][jt ラー込理^ 


I播能 （5 ■り-1 

[コール？ . «ftl 

I K 0 (ih I 


ZAH(-GDATE) 


なし 

HL i|- 1980-2079 

D fi 1-1 Jl-12=12 

A IVH 0-HW-8-:fcW 


! 解 at I このフアンクシ a ン ( i 上 se のような形式で内部の#レンダーの現合の値 

を遂します„ 


日付のセット 


[dosi] [x^-jaa] 



時刻の獲得 


IDOS1I |x ラー処理 | 



「コール T . なし 


[iR ') tt] H 時問 0-23 

L '!t 0 ~ •明 

D 抄 0〜59 

E 1/100 # JR に 0 

[解说丨 このフアンクシ 3 ンは上 se の形式でシステムク〇ックの现在の狄を返し 

it. 

クロックチップが t/io* 秒舉位で什時できないため、 E レジスタには常 
に〇が返されます， 


時刻のセット 


[«Ml6 # '•；] 

[コール:！ ■ *| 


R 0値 


2DH(.ST1.V1E) 

H 呤曲 0~23 

L 分 0-59 

D 秒 0~B9 

E 1/100 tP 無视される 

A 00H 時刻が冇効 
FFH 時幼が無効 


IDOS11 IZ9-«&aj 


[解说丨 このフアンクシ3ンは内部のシステムクロックを报定の時刻の«にセノ 

卜します。時刻が無効であると、 A レジスタは 0FFH として返されてエ 
ラーを示し、現在.の8.1•刻は変史されません.時刻はリアルタイムク〇ック 
チ y ブに保持されるため、マシンの®®を切っても更新されます。 

ク a ックチップが1/100秒承位で改定できないため s E レジスタの M は 
無 a されます。 



ベリファイフラグのセット*リセット 


IDOS1I 


[エラ- »H] 


[機能* 分 | 2EH( VERIFY) 

[3 -ル E 0 ベリフ T イを無効に 

0以外ベリファイをィ1効に 


[R ') lift ] なし 

解说| このフアンクシ3ンはすべての方き込みの IK の flifi 的なペリ 7r イを 

冇効あるいは無効にします。 MSX DOS が起 M したときにはデ7ォルトで 
はオフになっています • ベリファイを冇効にするとシステムの估級 H. は向 
} •上ますが、树時 UftS 込みのXビードが低 F します。また、この！*能は 
ディスクドライパに依存するため、ドライパがサポートしていない!:ベリ 
7 r イ觔作は行われません， 


アブソリュートなセクタの読み出し [posij | i 5 -»aj 


[嫌 116 ( 2FH(_RDABS) 

[a -ル TUfil DE セクタ 番ぜ 

L ドライプ* 0= A : など 
H 纶み出すセクタ数 


f m •) 他] 


エラーコート* 0- エラーなし 



アブソリュートなセクタの書き込み [ DOST ! 

[機能•号 J 30H(.WRABS) 

「コール手取| DE セクタ番号 

L ドライブ*号 0-A: な K 

H S き込むセクタ ft 


A エラー:!—ド 

このファンクシ3ンはセクタをファイルとして解釈する 
スクへセクタを a; 接#き込みます，セクタ# y •をディス 
丙に*換するため、ディスクは •« 幼な DOS のディスクで< 
せん，セクタは坩 A のディスク te 送アト•レスから«き込ま< 
クェラーは; i 常の方法で知らされます。 


ディスクパラメータの獲得 

[梭能# 号丨 31H(JJPARM) 

丨コール手順| 


DE •ディスクパラメータ （32 パイトのパ y ファ） 

L ■- 'D^- 
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フ7•ンクシ a ンの*明 




オフセット 味 

DE+1,2 セクタサイズ（現在は常に！112) 

DE+3 クラスタごとのセクタ数 

<2の !!#•> ただし u は1以卜.の》»> 
DE+4. 5 チ約セクタ《 (通常 1) 

DE+6 FAT の攻（通常2> 

DE+7, 8 ル-トデ•（レクトリのエントリ数 
DE+9. 10 al 埂セクタの総 ft 

DE+1X メディアディスクリブタパイト 

DE+12 FAT ごとのセクタ» 

DE+13-14 ルートディレクトリの*初のセクタ番号 

DE+15-16 AiW のデ-■夕のセクタ®■号 

DE+17-18 鉍大クラスタ*号 

DE+19 ダーティディスクフラグ 

DE+2( 卜23 ボリ •》- ム ID ( 1=ボリューム ID なし） 

DE+24-31 システム予約（現在は常に0> 


ダーティディスクフラグは，ディスク屮に UNDEL コマンドで恥•舌で 
きるファイルがあることを示すフラグです。した! ft* つて、ファイルあるい 
はディレクトリにクラスタが M リ，てられるとこのフラグはリセヴトされ 
ます。 


最初のエントリの検索 

1機能# y 1 

40H(-FFIRST) 

1 コール 手烟 1 

DE ドライブ•パス•フ r イル ASCIIZ 文字列または FIB ポインタ 

HL 検索ファイル名 ASCIIZ 文ネ•列 （DE»FIB ポインタである場合のみ） 

B 検索《性 

IX 斯しい FIB へのポインタ 

1 « り® 1 

A エラー; J- ド 

(IX) 一致するエントりが入る 

[ « at ] 

义字列の 1 ■ドライブ•パ Xj 部分、あるいは F1B (フ T イル衍報ブ〇ッ 
ク）は検索するディレク1•りを指定します。ファイルを指定する FIB が渡 
されると、 •'•iATTRj エラーが返されます，文•笋列の•■ファイル j 部分、あ 
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るいは HL が指す検索ファイル名 ASC11Z 文字列は、どういったファイル 
名を一致させるかを決定します。一软したものがない場合には 「.NOFILj 
エラーが返され、あった場合にはIXによって指される FIB が一致するエ 
ントリの怙報で满たされます。 

このフ T イル名には<7イルドカード文中 < r 7j および r *j> を含めても 
よく、その場 ft ■には M 初に一致するエントリが返されます。フ T イル名が 
ヌル （DE で指される ASC11Z 文字列がタルであるか r ¥j で ft わってい 
るか，あるい (iHL で指される検索77■イル名文字列がヌルの場 M であ 
ると、このファンクシ3ンはあたかもフ T イル名が 1 ■木.* j であるかのよ 
うに振るまい、したがってすべての名'麻が-致します。 

B レジスタ中の R 件パイトは一致するエントリのタイプを指定します， 
これが0だと、不可视でもシステムファイルでもない7 T イルだけが見つ 
けられます。 B レジスタにデイレクトり、イく "f 祝あるいはシステムビット 
がセットされていると、これらのを持つエントリが通常のフ7イルと 
ともに--致するようになります。 bv •ジスタの«み出し vm およぴア ー* 
イプ！ i ットは挺《されます。 

B レジスタのポリ;!•ーム名ビットがセットされると検索は嫌他的に行わ 
れ，ボリ1ームラベルのエントリだけが橡*されます。この場介にはまた 
FIB とファイル名あるいはドライプ_，<ス•フ7■イル文字列はドライプの 
坩定を Kt いて無视されます。つま*)、ポリム*定のフ7■イル名 C 
—软 t るかどうかに明わらず、もし存在すれば，ルートディレクトリ中て 
a つけられます • 

DE が FIB を指している場合，必要な•らIXも間一の HB を指すことが 
できます。この場合，一致するものが見つかると、析しい PIBU 古いもの 
を fi ね*きします。 


次のエントリの検索 


[機能番号1 41H(JNEXT) 

[p- ル手)® I IX以前の最初のエントリを検索するフアンクシ9ンから返された FIB 

へのポインタ 


A エラー 

(IX) 次の一致するエントリが入る 


このフ T ンクン3ンは初のエントリの横索 j フアンク v ヨン：！ール 
の後でのみ使用しなければなりません。これは 1 ■最初のエントりの検索 j 



新しいエントリの検索 
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B レジスタ*!*に®される W 性バイ I •は斷しいエントリに付％•すべ # Wtl 
です，ボリューム名ビットがセットされていると、ルー ■ ■ I , ■ ■ -F 
にボリューム名が作成されます。ディレクトリピットがセットされている 
と、作成されるエントリはサブディレク I •リとなり，そうでない塌合には 
ファイルとなります。フ7■イルには，システム、不4礼および iitAfli し 
#用 t ： ットがセットでき、サブディレクトリにはイ 、 "f 视ビットがセットで 
きます。フ7•イルは常にアー々イブ®性ビットをセ;/卜して作成されます， 

ファイルは現在の H 付と時刻で fc さ0で作成されます。サブディレクト 

J の«介には1つのクラスタが»|り， 1 i てられ、 r.j および 「..J エントリが 
適切に初期化されます。 

指定した名前のエントリがディレクトリ中にすでに存在した場 ft，B 作 
は 1 ■新規作成フラグ j (B レジスタの tT ット 7) 、およぴエント U のタイ 
ブによって興なります。 1 ■新祝作成フラグ j がセットされていると、常に 
r-FILEXj エラーが返されます，したがってこのフラグをセットすると 
味存のファイルが№1除されないことが保 ar されます。 

すでにエントリが Tffl ： し、•■新規作成フラグ J がセットされていないと 
既疗のエントりのタイプが渊ベられて、それが析しいファイルを作成する 
ために削除できるかどうかを料断します。エントリが说み圯しフ r イ 
ル ( r .FILROj エラー）、システム7ァイル （ r .SYSXj エラー〉、あるい 
はサブディレクトリ （ r .DIRXj エラー> である場合、また、このファイル 
に対してすでにオーブンしているファイルハンドル C.FOPENj エラー} 
が存4する*6会，エラーが返されます。サブディレクトリを作成しようと 
しているときは、通常のファイルであっても削除されません < r .FILEXj 
ェラ-)。 

これらのエラー < rFILEXj . r PILROj , r.SYSXj 、 r.DIRXj , 
「.FOPENj ) が発也すると、 WJ? のエ〆卜の倩報が FIB に S き込ま 
れます。この F1B はあたかも r * 初のエントリの検索 j ファンク，〆3ンで 
返されたかのように使用することができます 0 



ファイルハンドルのオープン 



ファイルハンドルの作成 


I梭能赛号_ 44H し CREATE) 

「コール DE ドライブ.パス.ファイル ASCIIZ 文字列 
A オープンモ ー！•• 

bO セ"/卜畀き込み»止 
bl セット及み出し货止 
b2 セット斟水 
b3-b7 必ずクリア 

B b0~b6 5J 求する»•注， b7-Tf 規作成フラグ 


「 * り®丨 A エラー 

B 新しいフ T イルハンドル 

I 拐说| ファイルまたはサブディレクトり （Bvy スタの«性の mt による）が 

ドライプ.パス•フ7■イル文字列によってキ g 定される名前およびそのディ 
レクトリ中に作-成されます。 B レジスタがボリム名を n ? 定していると 
「.IATTRj エラーが iK されます 《• 

フ7•イルまたはサブディレクトリが作成できないとエラーが返されま 
す。この場合のエラーの'雄は、•■祈しいエントリの検索 j フ7■ンクシ3ン 
(P.291 参照）のものと冏匕で、主なエラーコードは r .FILEXj, r .DIRXj、 
r .SYSXj.「.FILROj、 r .FOPENj、 r .DRFULj、 あるいは 「.DKFULj 
です • •■斯しいエントりの検索 j ファンクシ 3 ンと R 様.•■新規作成フラグ j 
(B レジスタのビット7> がセットされていると、既存のファイルは削除さ 
れず、 r .FILEXj エラーが常に返されます。 

«性パイトがサブディレクトりを指定している場合には、不可视ビット 
をセットして不可枚のサブディレクトリを作成すること fc できます。ファ 
イルの場合■は不可視.システム、あるいは嫌み出し墀用ピットをセットし 
てそれぞれの®性を持ったフ7•イルを作成することができます。不正な« 
性ビットは無视されます。ファイルは常 K ア-々イブビV I•をセットして 
作成されます。 


ファイルは前述の r ファイルハンドルの才-フ•ン J フ7■ンクシ3ン （P.295 
参照）の場合と問様、自勒的にオープンさ# U フ7■イルハンドルが B レジ 
スタに返されます。 r オープンモード j ハ•ラメータは、 r フ t イルハントル 
のオーブン j ファンク-〆3ンの場合と同棣に解釈されます。サプディレク 
トリはオープンされない（これをオーブンするの<1:無息味）ため、 B レジ 
スタに効なファイルハンドルとはなり得ない 0FFH か返されます。 
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ファイルハンドルのクローズ 

[機能# 号 45H(.CL«SE) 

f コール B フ7•イルハンドル 

[K ') ilft] A X7- 

[tf 3L 1 i のフ r ンクシ s ンは指定のフ r イルハンドルを解放して押利用でき 

^ るようにします。ハンドルにファイルが*き込まれていると、そのデイレ 

クトリエントりが新しい U 付と時刻で_«新さ* U アーカイブ Wtt ビットが 
セットされ、そしてすベてのパッフ7•屮のデータがディスクに？され 
ます。この 7T イルハンドルを嫌けて使おうとするとエラーとなります。 
r 7r イルハンドルの省 Kj (P.2079 .明）や r + プロセスの起助 j ファンク 
シ s ン （P.318 事で作*されたこのファイルハンドルのコビーが別に存 
在する場合には、これらのコビーは嫌けて tt 用することができます • 


ファイルハンドルの確保 


「機能番 f 

コール-?-峨I 

[K 〇1»] 

f 解％ I 


46H(_ENSURE) 

B 7アイルハンドル 
A エラー 

ファイルハン I••ルに77•イルが SS 込まれていると、そのデ•{レクトり 
エント U が新しい Hft と卟 Sl| で8新され、アーカイブ R 性ビツ1•がセット 
され、そしてすベてのパッフ T 中のデータがディスクに®き出されます • 
フ T イルハンドルは解放されないためそれを使用して较けてファイルを 
アクセスすることができ、現在のファイルポインタの a 定は変りません， 


ファイルハンドルの複製 

[ 檐能 * 司 47H(J5UP) 

Iコ—ル- fie] b ファイルハンドル 

[R •) tfi] A i ラー 

B 料しいフ r イルハン！••ル 
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解说| このファ 〆 クン9ンは指定のファイルハンドルのコピ_を作成:します， 

利用できる最小のフ5•イルハンドル S 5 J - が常に使用され，利用できるもの 
がないと r . NHANDj エラーが返されます • 析しいファイルハン I ■•ルは元 
のものと同一のフ7■イルを麥照し、そのどちらを使用してもかまいません， 
-方のハンドルのフ r イルポインタが移劾されると他方もまた移動されま 
す。どちらかのハンドルがクローズしても、他方は较けて使用できます。 

このファンクシ3ンで fls 成される ftK ファイルハント•ルは「別々にオー 
ブンされた j ものではないため r - FOPENj エラーを牛成するような別々 
のフ r イルハンドルとは兄なされないことに注®して下さい。例えば 、 1 "ft 
» j ファイルハンドルは名闽を女圯したり < P ,309#. TO 、 その»性を «+ C し 
/-•) ( P .310 幸照）できますが、その効果は肉方のハンドルにおよびます， 
持に， r ftKj フ r イルハンドルのひとつのコビーが削除され S ( P .310 
赛照> と、フ7■イルは灾除に MM ； されるので、他方のフ7•イルハン！■•ルは 
オーブン L たままの状®ですが、安全に使 HI することができなくなること 
に注 S して下さい。それが（クローズ、 »!*. あるいは削除以外で）使用 
されると r . HDEADj エラーが; ii されます。 


ファイルハンドルからの読み出し 

I 梅能* 好 I 48 II (. READ ) 

Iコール B ファイルハンドル 

DE パフフ T アドレス 
HL 婕み込むパイト K 

[ el *) tt 丨 a x ラー 

HL 笑際に K み込んだパイ！•数 

指定されたパイト数をフ r イルの現在のファイルポインタの位 S から 
DE レジスタて•拼定されたバッファ T ドレXへ较み込み、7ァイルポイン 
夕はそれに絞くパイトに K 新されます。フ7•イルハンドルが r Sil み出し5! 
止 j アクセスビットをセットしてオーブンされた場合には、 r .ACCVj エ 
ラーが返されます- 

说み込まれたバイ ト数は要; RS れた数よりも少ない場合もあり、 エラー 
がない ■には レジスタ HL に说まれた a が也されます。 - Htt 的には、要 
求よりも少ない数が;*み込まれた％合'.エラー状怒としては級ってはなら 
ず， r .EOFj エラーが 遂されるまでは， its を a むためにさらに » み出し 
を行わなければなりません。 r . EOFj エラ-' li 部分的な統み出しでは返さ 
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れることはナ*‘く、0パイトを, il む 《AAfl 比の堪合にだけ返されます • この 
ようなフ7イルの読み出しはデバイスファイルハンドルが£しく肋作する 
ことを保 tf します。 


ディスクファイルでは、较まれたパイト»はエンドオブ7 7•イルに迮し 
た場合にのみ要求した数よリも少なくなり，この場合.次の说み出し班琛 
が U パイトを;;«んで、 r .EOFj エラーを返します。デバイス77•イルハン 
ドル（例えば0から4のファイルハンドル〉から拽み出すと、その袖 
作はそれぞれのデパイスによって光なり，また、その M み出しのモ■ドが 
ASCII かバイナリであるかによっても K なります（後述のファンクシ3ン 
を参照し W も一般的に使用されるテパイスである f CONj デパイスを例 
にとって说明しますが、他のデバイスも问様に#))•作します。 

r coKj デパイスからバイナリモードで sa み出すと、変換された*/,妈 
曲やプリンタにエコーされることなしに、キーボードから文卞が si み出さ 
れます> 焚水された止嫌な文卞数が S8 に i* まれ.エン！••オブファイルの状 
態は合わしません。エンドオブ7 7■イルの状®が??夜しないため、パイナ 
リモ-ドでデバイスを31み出すときには供*に行わなければなりません。 

r CONj デパイスか b ASCII モード（デフォルトモードで、棵承人力 
チヤンネルに通常 am される）での ii み出し77■ンクシ*ンコ_ルは、人 
力を1忖统むだけです，人力行は、通«の行の* ul£ 檐能をユーザーに利川 
できるようにして、キーボート•から atA 込まれ、人力された文字はI两而に 
エコーされ、 -p が冇効な場 ft ■にはプリンタにもエ 3 — されます。特殊な 
制御文字 r ~Pj, r ~Nj, r-'Sj, および r ~Cj が»ベ b れ、「コン y- ル 
ステータス J (P.27.1$») の*8合とまったく冏後に Kill されます。 

ユーザーが〔VIキーを人力すると，行は玫み出しパッ7 7■にコビーされ、 
CR-LF シーケンスが Ai 後に W/W され，迪切なパイト数が说み出しファン 
クシ a ンから返されます。次の说み出しは、別のパ _r フ7■行入力％邶を期 
始します。说み出しで挺求されたパイト》が行人力の K さよリも小さい墦 
会には、と闻じ文卞数が返され、次のはみ:I•，し7ァンクシヨン: j ール 
は行をすべて说んでしまうまで、その行の残りの部分を即|£に逛します。 

ユ-ザーが r~ Zj 文字で始まる行を人力すると、これはエンドオブ 7T 
イルを示すものとして解釈されます。この行は捨てられ、说み出し7 7•ン 
クシヨンコールは0バイトを斑み， r .EOFj エラーを&します。これに执 
く ■* み m しは，通常に域り、別の行人力を始めます。このように、エント 
オブ7ァイルの状想は永枝的なものではありません， 
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ハン ドルへの書き込み 

[機能番 V] 49H(—WRITE) 

I コール 手明 j B ファイルハンドル 

DE パ-/7 V■アドレス 
HL 并き込むパイト数 

[戾リ値 i A エラー 

HL 実味に古き込んだパイト数 

[W ai ( この7?•ンクシ3ンは 1 ■班み出し J フ7•ンクシヨン （P.298 事照）と大 

変似ています。のパイト教がフ7•イル中の現在のフ7■イルポインタの 
位1に井き込まれ、フ t イルポインタき込まれたパイトの at 後を 
指す i つに更新されます。7アイルが込アクセスピ•を 
セットして才ープンされた場合には、 r .ACCVj エラーが&3れ、フ7■イ 
ルが嫌み出し専用であると f .FILROj エラーが返されます。 

古き込みが织 A のエンドオプファイルを超えて行われると、7アイルは 
必要に応じて拡張されます。ファイルボインタがすでにエンドオプフアイ 
ルを超えていると、ディスク»域が W を埂めるために泊!リ当てられ、初期 
化されません。ディスク領域が十分にないと、 「.DKFULj エラーが返さ 
れ、データの一部を入れる余地があったとしても.データはまったく方き 
込まれません。 

嗇 き込まれたバイト数はエラーが返された場合には0、嗇き込みが成功 
した塌会には*求した数と等しいため、通常は無拽できます，多くの小さ 
なブロックよりも少 ft の大きなプ〇ックで 7T イルを/ Ti 込んだ方が効率 
的であるため、プログラムでは*にできる！®り大きなブロックて* Sii む 
よう K した方が A いでし！:う. 

このフアンクン3ンはフ7•イルハンドルに 1 ■変更有り j e ットをセット 
し、それによって、ファイルハント•ルが明示的にせよ咔黙にせよクローズ 
3れた Off 保されたときに、 r< レクトリエントリが新しい H 付と時刻、 
および新しい鞠り当て情報で史新されます。また、アー々イプビットがセ/ 
卜3れ、このファイルが®後にアーカイブされた後に変 E されたというこ 
とを示します《 

デパイス7アイルハンドルへの？{•き込みは、エンドオブファイル状®や 
行入力を考成しなくて{(よI、ため、54み出しのように換»ではあリません. 
r CONj デバイスへの S き込みの B に、 ASCII とバイナリモート•との問に 
は相逢があり、コンソールステータスのチ * ックは ASCII モートでたけ* 
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hr されます。ブリンタエコーが有効の場合も、 ASCII モードでだけX行さ 
れます。 


ファイル ハン ドルポインタの移動 


[«E * «•] 

1コール f 


4AH(.SEEK) 


B ファイルハンドル 

A 方式コード 

DE:HL 符 W 付きオフセット 



[W 說丨 指定したフ7■イルハンドルに* S 合したファイルポインタを方式コードと 

オフセ y 卜にしたがって変 S し，新しいポインタ馓を DE:HL に返します。 
A 式コードは符号付きオフセットがどこからの扣対であるかを以下のよう 
に街定します。 

A=0 ファイルの先頭から相対 
A=1 税在の位!5から相対 
A=2 エンドオブファイルから相対 

オフセット0を指定すると移 W 方式コード1は m に現在のポインタ他を 
返し、移肋方式コ ー! •• 2はファイルの大きさを返すということして 
下さい，エンドオブファイルのチIツクは行われないので、ファイルボイ 
ンタをエント*オブ77•イルを超えてセツトするこ！：は可能です。「ファ . 
ルハンドルの «Kj (P.297 参照）あるいは 1 ■子プロセスの IiSWj (P.318# 
照）で作成された、このファイルハンドルのコビーがある場合には、それ 
らのファイルポインタもされます。 

ファイルポインタはランダムアクセスが可能なデイXク7 7•イルでのみ 
実際に ffi 味を持ちます a デバイスファイルでも、フ7•イルポインタはすべて 
の说み出しあるいは*き込みの際適切に E 新され、またこのファンクシ3 
ンで典ぺたリ変!£したリすることがで S ます，しかし«史は効*がな•く 
そナ1•を典べることが役にたつ場命はまずありません， 



302 


第 17 章フ r ンクシ a ンコール 


デバイスの I / O 制御 



4BH(JOCTL) 

B フ t イルハンドル 

A サブフアンクシ3ンコート* 

00H 7 r イ ルハンドルの状®!の® 〇 
01H ASCII «バイナリモ_ドのセ y 卜 
02H 人カレディの検 A 
03H 出カレディの検资 
04H W 而サイズの検出 
DE 他のパラメータ 


DE 他の絃采 


[W 躭I このファンクシ8ンによって、フ r イルハンドルの秘々の状®を羽ベた 

リ変史したりすることできます。持に、こを使坩してファイルハント • 
ルがディスクファイルを麥照しているのかあるいはデパイスを窬照して.い 
るのかを W 断することができます。これは、ティスクフ7•イルとデバイス 
I/O で*なった M 作をしたいプログラムで役に立ちます • 

このファンクン3ンは B レジスタにファイルハンドル、 A レジスタに！ a 
现を指定するサブ77■ンクン5ンコードを杜して突行します。特定のサブ 
ファンクン s ンで必となる他のすべての •<* ラメ ータは DE レジスタに!_度 
し、結果は DE レジスタに S リます。サブファンクレ*ンコードが不正だ 
と、 MSBFNj エラーが也されます。 

A=0 だと* i 理は 1 ■ファイルハンドルステ*-タスの播得 j となります。こ 
れは、ファイルハンドルについての®々の依锒を与える17-ドのフラグ 
を遇します。この17— ドのフォーマツトはデパイスフ7•イルハンドルと 
ディスクファイルハンドルでは異なり，ビット7がどちらかを指定します。 
この 1 7— ドのフォ ー7 ツI•は次のとおりです。 



• デパイスの場 ft _ 

ビット A 味 

DE 0 セ•ノト=コンソール入カデバイス 

1セット= 3ンソール出カデパイス 
2-4 システムダ#.』 


5 セ-/ I*=ASC：I1 モード 


クリア=パイナリモード 
6 セ y 卜=エン P オブフ7■•{ル 
7常にセット （= デノ<イス） 


8-15 


• ディXクフ T •{ルの坳 fr _ 

ビット 《味 

EE, 0-5 ドライブ*号 （0=A: など） 

G セット=エンドオブファイル 
7 «にクリア <=ディスク7ァイル> 

8-15 システム予約 

エンドオプファイルフラグがデバイスの塲合とディスクフ r イルの場介 
で M じ位两にあることに n:® して KS い。デバイスの^4合には、デバイス 
からの ifim の SftAfB しが r .EOFj エラーを生成したときにセットさ R、 次 
の决み出しによってクリアされます，ディスクファイルの增合には，フ T 
イルボインタとファイルサイズを比較することによって作り出されます。 

A=l のとき、 few. は 「ASCII ■•パイナリモ_ドのセット j となります • 
この！ 4® はデパイスフ7■イルハント•ルの場合にだけ•できます。 ASCII 
パイナりフラグはレジスタ E のビット5 ( r 7 7 ■イルハ〆ドルスデータス 
の® 13 j によってそれが返されるところ）に教しておかなければなりませ 
ん。これは ASCII モードではセ •/ 卜、パイナりモードではクリアとなりま 
す- DE レジスタの他のすべてのピソトは*祝されます， 

A=2 または3の >S、ft 現はそれぞれ 1 ■人カレディの埃または 1 ■出 
カレディの検となります。どちらの場合も、フラグかレジスタ EG* 
され、フ7■イルハンドルがレディであると FTO、 そうでないと 00H となり 
ます， r レディ j の S 味はデバイスによって與な*)ます。ディスクファイル 
ハンドルは常に fh 力についてレデイであり、ファイルポインタがエンドオ 
ブフ T イルにない限り入力についてレディです。 rcoNj デバイスはキー 
ボードの状! S をチ**/クして、それが人力についてレディであるかど，か 
をします- 
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A=4 のとき、処理はサイズの技得 j になります-これは行数を D 
レジスタに、列«を E レジスタに入れて、そのフ7■イルハンドルの治理两 
曲サイズを返します。|«而サイズがないデハ•イス <ディスクフ7•イルなど> 
で(4» D fcEtO になります。したがって、どちらが0でも，それは「無 
限 j と解釈します。例えば.この 7r ンクシ-：»ン Ulfi に我/するフ r イ 
ルの数を利断するために r DIR /Wj コマンドで使用され、 E レジスタの 
侦が0の場介、デフォルトの 8(1 t して扱います， 


ファイルハンドルのテスト 

能# り I 4GH(_HTEST) 

1コール手期] B ファイルハンドル 

DE ドライブ*パス•ファイル ASCIIZ 文字列または FIB ポインタ 

I戾り値 I A ェラー 

B 00H 阏じフ r イルでない 
FFH 冏じファイル 

[解说1 この特殊なファンクシヨンには、フ r イルハンドルとファイルを Hi 別す 

るI••ライプ•パス•ファイル文字 H あるいは F】B ブ〇ックを®します。こ 
のフ7■ンクシ》ンは2つのファイルが文際に1功じフ r イルかどうかを料斯 
し、その絃果•示すフラグを返します。ファイルハンドルがデイスクフ r 
イルでなくデバイスのものである埏合には、 HS1— のファイルでない j こ 
とを/7；•す 「B=00Hj が常に返りま1% 

このファンクシ s ン <=よって、 COPY コマンドがファイルをそのファイ 
ル0分の上にコビーしてしまうなどといったある a のエラ_の状想を検知 
することがで s、 ユーザーにそうした_麻報をエラーメッセージとして表/丁く 
することが"I能です。これは、向様の検;&が必要な他のブログラムでも利 
用できます。 


ファイル • サブデ（レク上^1の削 f 余 

[ 楱竺番号 ] 40H(J)ELETE) 

〔コ ー ル- T lft| DE ドライプ•パス.フ7•イル ASCIIZ 义字列または FIB ポインタ 

r ^ 0 Wl 1 A エラー 



解说] このフ7■ンクシヨンはドライブ•パス•ファイル文宇列ある “liFlB で 

指定されるもの（ファイルあるいはサブディレクトリ）を削除します。ワ 
イルドカード文ネは許されず、この7ァンクシ3ンではひとつだけのファ 
イルまたはサブディレクトリが削除できます。サブディレクトリは’ 4i であ 
る場 ft にのみ削除でき、空でないとエラー ( r .DIRNEj) となります。サプ 
ディレクトリ中の 「.j と r -j のエントリは別除できず ( r .DOTj エラー)、 
ルートディレクトリも削除できません。フ r ■イルはオーブンされているファ 
イルハンドルがある場合 ( r .FOr>ENj エラー)、あるいは ift み出し办用で 
ある場介 （「 JUROj エラ—）には、削除することがてきません。 

ファイルの垛合、それに対して袖り、 1 S てられていたすベてのディスク® 

が解放されます，ディスクが MSX DOS2 のディスクであると、 UNDEL 
3マンドでファイルを很话するのに十分ながディスク|-_に¢1されます. 
この W [報はそのディスクで次にデ•(スク两域の： W リ当て （* 常フ r イルへ 
の卉き込み）が实行されるまで残されます。 FIB が i« された場合には、 i 
のファンクシ s ンの支行後は、それを 1 ■次のエントリの検索 j ファンクシ3 
ンに!*す場合以外には使用して fi いけません，なぜならそれが#照してい 
るフアイルはも，存 A しなくなっているからです。 


r CONj などの于•パイス名が ffi 定されるとエラーは返されませんが、そ 
のデパイスは其限には削除されません。 


ファイル名 • サブデイレクトリ名の変更 


[_ 機能番ゆ . 4EH(J?ENAK1E) 

[3 — ル乎 IB] DE ドライブ.パス.ファイル ASCIIZ 文字列または FIB ボインタ 
HL W しいフ7•イル名 ASCIIZ 文字列 


[M り値| A ユラー 

I解 W 1 このファンクシ*ンはドライブ■パス•ファイル文字列あるいは F1B で 

指定されるフ T イルあるいはサブディレクトリを. HL で}»される文亨列 
中の耕しい名筋に変®します。祈しいフ T イル«文卞列にドライブ文字や 
デイレクトリバスを A めると r .IFNMj エラーになります • r CONj など 
のデバイス名が析定されるとエラーは返されませんが、そのデパイスは矣 
際には名前の変 jg ほされません， 


ワイルドカード文字はドライブ•パス•ファイル文字列中では使用でませ 
ん《したがってこのフ7■ンクシ a ンで名谢を変史できるファイルあるいは 
サブディレクトリはひとつだけです，しかし.ワイルドカード文卞は HL 中 
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に渡される坊しぃファイル？;では使 W でき，それが； J 当する位 E では、％ 
存のファイル名文字が変®されずに残ります。その際には、不 1F なファイル 
名が作成されるのを避けるため-チュックが行われます。えば、 r XYZj 
というファイルは新しいファイル名文字列 r ????Aj へは変！ E できません 
(新しいファイル？;は r XYZAj となリ，不 JE であるため)，この椹合には 
r .FFNMj エラーが返されます。 

すでに新しいフ r イル名と W じエントリが存礼する埸合には 、エラー 
( r .DUPFj) が返されて重供したファイル名を作 r,)C するのが|"1«れます< 
サブディレクトリ中の r .j とのエントリは名的を変史できず (MDOTj 
エラー)、ルートディレクトリ名の変 K6 できません（ルートには名前がな 
い）。オーブンされているフ r イルハンドルを待つファイル < r .POPENj 
エラー）はファイル名を变疋できませんが、 S み出し埤用ファイルは名® 
を変 E できます。 


DE が FIB を fit していると、これは析しいファイル名に E 祈されないこ 
とに il.S して！'い，したがって、このファンクシ3ンコールの戈} T 後 
FIB を使用する場旮には伴$か必要です。 


ファイル • サブデイレクトリの移動 


[«{ 陡番号 I 4 FH (. MOVE ) 

p — ル手畊1 DE ドライプ.パス•フ7■イル* SCIIZ 文卞呙または FIB ポインタ 
HL 新しいパス ASCIIZ 文字列 

[M *) M | * i ラー 

I 解说 I このフ r ンクシ3ン11ドライプ•パス•ファイル文字列あるいは F 1 B 

で析 i されるファイルあるいはサプディレクトリを、 HL で指される新し 
いパス文字列で捎定されるディレクトりに移 M します • 新しいパス文字列 
中にはドライプ名があってはなりません。 「 CONj などのデパイス名が指 
定されるとエラーは返されま•せんが.そのデバイスは尖際には移動されま 
せん， 

ワイルド: ❖ー ド文卞はどの文卞51|中でも使用てきないため，このファン 
クシヨンで移||#て•きるファイルもしく U サフ•デイレクトリはひとつだけで 
す.，ただしサブデイレクトリが移勒された場公，その下にあるすベてのファ 
イルおよびサブデイレクトりは、それに伴って移動されます。すでに移動先 
のデ ■< レクトり中に梅:£の名麻のエントリが存在すると 、 r -DUPFj エラー 
が返されて®後したフ7•イル名が作成されることを防きます-サブディレ 




ファイル属性の獲得•セット 



ルハン K ルがオープンされている7アイルの班忡を変史することはて•きま 
せん （ r .FOPENj エラ-^。一方 1 '.J および r ..j デイレクトリエントリ 
の K 性11変!£することができます。 r CX).Nj などのデパイス名か•梢定され 
てもエラーは返されませんが、デバイスの«住は•夫: R には変史されません。 


ファイルの日付および時刻の獲得.セ ット 


[檐能 S S 
[ コール f せ ) 



DE ドライプ•パス • ファイル ASCIIZ 文 T 列または FIB ポインタ 
A 0 口付と時刻の®得 
1 H 付と#^刻のセソト 
IX 析しい時刻の «U-1 の坶介の 
HL. 新しい Q 付の值 （A_l の* JJ 办のみ） 


<) tftl A ェラ - 

DE フ7■イルの時刻の現在 tfi 
HL 7T イルの H 付の現在 W 


[解： ft 丨 A=1 の椹合、このフ r ンクシ 3 ンはドライプ.パス•フ r イル文す列 

あるいは FIB で指定されるフ r イルまたはサブディレクトりの lit 終修 IF 時 
糾および日付をセットします，このフ T ンクシ3ンではワイルドカード文 
卞が使用できないため， H 付と時 M を «EiE することができるフ t イルはひ 
とつだけです， 「CONj などのデパイ叉名がネ&走されてもエラーは返され 
ませんが、デバイスの H 付と朴刻は突際には変更されません， 


日付と時刻の形式はティレクトリエントリと F1B 中に保存されている6 
のとまったく同一です（13章 r ディスクフ7■イルの檐造 j を参照)。 H 付や 
時刻についてのチ*ックは行われず、値はただセットされるだけです .FIB 
が W されると、それにセットされた B 付と時刻はこの 7 t ■ンクシ*ンでは 
更斩されません， 

A=0 の場合、現在の侦がそのまま返されます。時劾の K をIXに渡しま 
すが.結眾は DE に®されるということに注意して — ドさい。オープンされ 
ているフ r イルハンドルがあるファイル （ r .FOPENj エラー）の H 付と 
時刻は変®できません （»A 出しは可)， 



ファイルハンドルの削除 


[ j 嫌能 S ■号 
[3 _ル手®I 



解 


A 


r.2H(_HDELETE) 

B ファイルハント•ル 
A ェラー 


この7ァンク：/ 3ンは指定したファイルを削除し、そのフ7•イルハンドル 
をクローズします。同一の7ァイルに«して別 W に才ーブンされた77■イル 
ハンドルがある場合には、フ7■イルハンドルは 1M 除できません （「.FOPENj 
エラー >• フ T イルハン！••ルの (• ■ファイルハ/ドルの後 5Sj あるいは 
•■子ブ〇セスの起ファンク Z3 ンで作成されるもの）が存 tt すると、こ 
れらの ttS! は使用でさないようにマ_クされ、これらを使用しよつとする 
と r .HDEADj エラーとなります • 

このファンクシ9ンのエラーの状態は、「ファイルあるいはサブデイレ 

クトリの削除 j ファンクシ3ン （P.304 参照1と同じです。エラーの状想 
( r .FRROj や r .F*PENj など）が#す:しても、フ r •(ルハンドルは常 
にク〇_ズされます • 


ファイルハン ドルの名前の変更 



ファイルハンドルの移動 

[機能济り： 54H(JJMOVE) 

「3 -■ル手顺| B 7 7■イルハント■ル 

HL 铒しいパス ASCIIZ 文 •}■: 列 

[ばリ W I A エラー 

解说I この77■ンクシヨンは析定のフ7■イルハンドルに枯合した7ァイルを、 

HL て析される新しいパス文字列で梢 ■£ されるデイレクトりへ移抑します， 
フ7•イルが ASCIIZ 义字列や HB ではな < ファイルハンドルで报定$れる 
ということを別にして，この77■ンクシ3ンは「7ァイルあるいはサブデイ 
レクトりの移 Wj ファンクション （R300 審 MJ と同じで、 |iij 一のエラー条 
ft を持ちます。 

ファイルハンドルはそのファイルに対してオープンされた剁のファイル 
ハン！••ルが存在する場合にはできません r.FOPENj エラ—）が、こ 
のフ7■イルハンドルのコビーが存在していても移励でき、2の坳合コビー 
も移動されます。フ r イルハンドルの移7ァイルボインタを変えませ 
んが、それはの 「tt 保 j 热理を実 iT します。 


ファイル ハン ドルの属性の獲得•セット 



ファイル ハン ドルの日付および時刻の獲得•セット 


機能》咬 56H(.HFTIME) 

コール T . Wft ] B 7 7 •イルハンドル 


0 H 付と時刻の梅得 

1 II付と WSI のセット 

祈しい時刻の値 A-1 の塌合のみ 
新しい口付の供 の場合のみ 

エラー 

フ 7•イ ルの Hi •刻の％在 fA 
フ7■イルの H 付の現在 Wt 






このファンクシ3ンは指定のフ7•イルハント•ルに結 "ft ■したフ7■イルの日 
W と時刻を推得または変更します。フ7•イルが ASCIIZ 文字列や FIB で 
はなく、ファイルハンドルで析定されるということを別にして、このフ T 
ンクシ3ンは•■フ7•イル HW •および W •刻の描得.セヴト j フアンクシ3ン 
(P.307 茶照）と固じで、同一のエラー状態を持ちます。 

フ7■イルハント•ルはそのフ7•イルについてオ_ブンされている別のファ 
イルハンドルが存在する場介には、その Q 付と呤釗を <搜得することはで 
きますが）変电することはできません <「.FOPENj エラ ー>• フ7•イルポ 
インタは変£されませんが、暗黙の 1 ■確保 j 処埤が実行されます c 


ディスク転送アドレスの獲得 


[エラ-棚] 



ベリファイフラグ設定の獲得 

@ 能# 分 58H(.GETVFY) 


[3 — ル手順] なし 

[K ') ffi ] B ’00H ベリ 77 •イ焦-効 
FFH ペリ7ァイ有効 


解说 ] このフ ■* ンクシ3ンは•■ベリファイ7ラグのセットリセ-/卜 j フ 7* ン 

クシヨン-.289参照）でセットすることのできるペリフアイ7ラグの現在 
の状逋を1-ます。 


カレントデイレクトリの獲得 



カレン」 し^ [ 匕クトリの変更 

能番号] 5 AH (. CHDIB ) 

Iコール- T-W(| DE ドライブ•パス•ファイル ASCIIZ 文字列 
I 民り Ml ] A エラー 

[W 说 ] ドライブ •パス•フ 7 •イル文字列 U7 ァイ ルでは なく ディレクトリを指 

定 しなければなりません。そのドライブの 々レントディレクトリは指定 さ 
れたディ レクト リに変 E されます。指定の ディレクト リが存在しない場合 
祝在の a 定は変更されす、 r . NODIRj エラーが返されます。 


パス名の解析 



ビット .5 •味 

0 ドライブ名以 )1 •の文卞か解析されたと$にセット 

1 ディレクトリパスか衍^されたと3にセット 

2 ドライブ名が衍定されたときにセ-/卜 

3 最後の項 H で主フ T イル名が析定されたと$にセット 

4 ft 後の項 H でファイル？が指定されたときにセット 

B Wt 後の項目にワイルド❖ー ドがあるときにセット 

6 ft 後の項 H が r .j あるい ti «■„_( のときにセ v 卜 

7 W 後の項 B が 1 '.のときにセ•ノト 


ファイル 名の解析 

j_m 能番 < 5CH(J>KILE) 


[コール手瓶I 


解析のための ASCIIZ 文字列 
バイトバッファへのボインク 



[解通 I このファンクションは純特な文字列掸作ファンクシ 3 ンであ 1 )、まった 

くディスクにアクセスせず、文字列に修正を加えることはまったくありま 
せん。この 7 t ンクションは主に外部ブ〇グラムがフォー マッ トされた形 
式でフ7•イル名を出力する T •助けになる為に用竞されています。 ASCIIZ 
文字列は-のフ7•イル名の項 B として解析され、フ r イル名はユーザー 
の11パイトのバッファに拡張された形式でセ/卜さ iu フ7•イル名およ 
ぴ抗 SET- の余白には空 fl が: S めりれます。 

B レジスタに返される解析フラグは上記の 1 ■パス名の解析 j ファンクショ 
ン （P-313 参照）と同じですが、ビット0, 1. および2は常にクリアされ 
ています。例え文字列中に冇効なフ7■イル名がなかったとしてもユ••ザー 
のパ'■ノフ r は常に捆たされ、その場合にはハ•ッファは空白で满たされます。 
r *j 文字は適肖な数の 1 "? j に E 明されます。フ7■イル名あるいは 7r イ 
ル名抗 5R 子が fi すぎると余分な文字は無找されます。 


DE レジスタに返されるボインタはフ r イル名の一部ではなかった文字 
列中の ft 初の文字を栴しますが、これは义宇列の終わI)にあるヌルである 
場合があリます，この文字は冇効な77•イル名の文字であることはありま 
せん術幼なフ7•イル 45 の文字の 3F 細：ついては•■この*の舰法 j を 
•照). 


文字の検査 


「機能* 号 ODH (. CHKCHR ) 

コール手 D 文字フラグ 
E 検《する文宇 


「 K リ讷| A 0(エラーを逛すことはない） 

D 更新された文宇フラグ 
E 検査された（大文字にされた）文字 


「解説丨 このフ r ンクシ S ンは SiffiSS ： とは独立して文字を大文字にした 1 h 2 

パイトの文字やフ7•イル名の技作をしたりするのに役立:ちます。文字7ラ 
グのビット刻り当てを次に示します， 



12 バイト文字の第 1 パイトの i きにセット 

2 2パイト文字の第2パイトのときにセット 

3 セット=ボリューム f ■(ファイル名ではな vO 
■X セット=有劾な 7T イル*，ボリューム名の文卞 

5-7 システム予約（常にクリア） 


ビ：/卜0は大文卞化を制 W するために ft 用します。これがクリアされる 
と、文字はそのマシンの3络3定にしたがって大文字にされます。このビッ 
卜がセットされていると、 S される文字は常に渡 S れた文字と闲一|こなり 
ます。 


2つの2パイト文 T の7ラグ（ビット1と2> は，文字列の Ai 初の文 T を 
チ i ックするときに由方ともクリアすることができ.返された»定は、较 
<文字のためにこのフ T ンクシ3ンに K 裱液すことができます，これらの 
フラグで、2パイト文字を含む可能性のある文字列を逆戻りする場合には 
注意が必要です。 

ビット4は文卞がファイル名やボリューム名の終)"文宇であると、セソ 
卜されてリターンします。ビット3は爆*«に、ファイル名の検査か.ある 
いはボリ.1-ム名の文宇の検2£かを決定するのに使 m 5れます（文宇セ .y 
卜が輿なるため) • 2パイI•文字（どちらの•^イトも）はボリュームあるい 
は 7r イル名の終了文卞として兄なされることはありません， 


完全なパス文字列の獲得 


[榼能番号 I 5EH(-WPATH) 

[3 -ル手順| DE 64バイトパッ77•へのボインク 


[« •) Ml A エラー 

DE 完全なパス文宇対で満たされる 
HL «i 後の項目のはじめへのボインク 


「解説] このファンクシ S ンは内部パッ 7T から ASCIIZ パス文卞外をユーザー 

のバッファへ単《 に:> ビー します。 文字角は、繭に*行された r S 初のエ 
ントリの検索 j (P.291# 照）あるいは•■新しいエントりの検索 j (P.293# 
照 > で見つけられたファイルやサブデイレクトリのルートディレクトリか 
らの完全なパスとファイル名を表します。返された文字列 {i トライブや* i 



ディスクバッファのフラッシュ 



子プロセスの起動 

[檐能番冷] 60H(.FORK) 

[コール手)^ なし 

[64 0値 1 A エラ… 

B 親プ〇セスのブ〇セX ID 


解说 ] このファンクシ3ンは•ノステムに対して了•プロセスが起勘されようとし 

ていることを報告します。 -|R 的にば》これは文行されようとする新しい 
プログラムやサブコマンドです。例えば、 COMMAND2,COM はすべての 
3マンドや外部ブ〇グラムを*行する前に， 「T ブロセスの起助 j ファン 
クン3ンコールを实 h ■します。 

斯しいファイルハンドルのセットが作成され、 r » 承アクセスモードビッ 
卜 j をセットしてオープンされたすベての* JMt のファイルハンドル（•■ファ 
イルハンドルのオーブン j ファンクション （P.295 参照）は析しいファイル 
ハント•ルのセットにコビーされます。「拥承ビット j をクリアしてオープン 
されたすべての77•イルハンドルはコビーされないため、-了.フ’〇セスでは 
利でき*せん。樣準ファイルハンドル （00H~05H> は#♦承で S6 ため、 
これらはコビ-•されます。 

斯しいプロセス ID が■子ブロセスのために割り当てられ、親プ a セスの 
プ n セス ID が返され、後で r * プロセスに戾る J フ r ンク y ョンコール 
(P.3185 照）で親ブロセスへ戾れるよつにします。フ7•イルハント•ルを ft 
K するのにメモリが足りない場合には r .NORAMj エラーが遐されます • 


■f ■プロセスはオリジナルではなくて以前のファイルハンドルのコビーを 
待つため、コビーのひとつがクローズされても元のものはオープンされた 
ままです • したがって，例えば+ブロセスが*力のファイルハンドル 
(フ r イルハンドル* vl> をクローズし、それを斩しいファイルに再オー 
ブンすると、「親ブ〇セスに戻る j ファンクシ s ンが关行されて籾ブロセ 
スに庚ったとき、元の®准出カチャンネルはまだ有効です。 


親プロセスに戻る 



17.3 7 アンクシヨンの i)t 明 


319 


[琪リ« I * エラー 

B 了-プロセスからの1次 エラー 3- ド 
C イ- フロ セスからの2次 エラー 3- ド 


[解说| このファンクシ3ンは指定の奴フロセスに¢4り， f. ブロセスが終了した 

エラーコー！••を b レジスタに人れ、 y •ブロセスからの2次エラーコードを 
C レジスタに入れてリターンします。親とチブロセス間の間{系は厳密 U 1 
対1です力*,このフ T ンクレ3ンは適切なブ〇セス ID をVえることによつ 
て、いくつかのレベルを飛び越えて R ることができます。フロセス[扉が 
•fvT であると r .IPROCj エラーが返されます。 

ザ•プロセスの7 7•イルハンドルのセットは打_にク〇ーズされ、期フ 
〇セスのファイルハンドルのセ-/卜が再ぴアクテイブになります。广プロ 
セスか«リ当てていたすベてのユーサー RAM セグメ /卜も解かされます。 

このファンクシ3ンに筱されたブロセス ID が〇であると、部分的なシ 
ステムの再扣期•文 H •されます。すべてのフ r イルハンドルがクローズ 
され、掠準人出力が扔才ーブンされ、すべてのユーザーセグメントが解放 
されます•この後ではコマンドインタ-■ブリタは正し v ，状®ではな 1 1ため 
ユーザープログラムはコマンドインタ_ブリタに珙ろうとするならばこれ 
を打ってはなりません • 

このフ7•ンクシ3ンは劣際にフ T イルハン（••ルをクローズする前に（つ 
まリディスクにアクセスする荊に）、メモリの«放とプ〇セス ID の调耔 
を行うように、な K® がなされています，これによって、デイXクエ 
ラーか起こって屮 W されても、趣琛は成功しているということが保证され 
ます。しかし r join Oj がディスクエラーを起こしてアボートする t, デ 
フォルトファイルハンドルの再初期化は其行されません。この場合には別 
の r join 0 j ファンクシ3ンコ-•ルを戈行しなければならす、これはデイス 
クをアクセスしようとしないため（すべてのファイルはク〇— ズされてい 
るため）成功します。 

このファンクシヨンコール J^OBVTDH を ilfi して実行されると B および 
C レジスタはエラーコードを也さないことに汰尨して F さい。これは、プ 
〇グラムの终了や中断の*1现はアブ i| ケーンヨンブログラムによって 
されなければならないからです 0 エラー：3— ドはア■ボートルーチンに政さ 
れており、そこにあるブ d グラムか•必要ならばエラーコードを堆してい 
なけれぱなリません。1次および2次エラーコードの意味については 1 ■エ 
ラーコードを伴った終了』ファンクシ 3 ン （p.320> も参照して下さい， 



：I20 


弟 17g 7 アンクシ 3 ンコール 


エラーコー ドを伴った終了 

丨棵能条 UI 62H(.TERM) 

[3 ■ル手順 j B 終 J" のエラーコード 

[« 'J 4¢ I なし 

し解说1 この 7T ンクシ9ンは衍定されたエラーコードでブ〇グラムを終 T させ 

^ ますが、このコードはエラーなしを， li す0であってもかまいません。この 
フ7•ンクン a ンコールは、ユーザーのアボートルーチンが«るように a 定 
されていない K り、呼び出し側に反ることはありません （P.320 1 ■アポ-卜 
終 'f ルーチンの定 Jgj を#照>〇このファンク-〆3ンの祺作は0005 H を iifi っ 
て MSX DOS の4?场からコールされたのか、あるいは 0F37DH を*って 
Disk BASIC の现壇からコールされたのかによって興なリます • 

0005 H を通ってコールされた坶 ft*、 ユーザ—のアボートルーチンが*■ア 
ボート終了ルーチンの定* j ファンクシ a ンによって定袭されていると 
それは指定のエラーコード（および0の2次エラーコード> を伴ってコー 
ルされます。このルーチンがリターンするか、またはユーザーのアボート 
ルーチンが•走茬されていない場 fr、M 卯はアドレス000 0H へのジャンプを 
経由して外部プ〇グラムを〇—ドしたルーチンへ戻されます。これはほと 
んど常に3マンドインタープリタです**,場合によっては別の外部ブ〇グ 
ラムであることもあリます，エラーコ_ド <i ンステムによって記世され、 
其行される次の 1 ■奴ブ〇セスに戾る J 77•ンクンヨン （P.318 参照> がこの 
エラーコードを返します，コマンドインタープリタは 20H-FFH の間の 
すべての 3 -ドについてエラーメッセージを衣示しますが，それ以下のエ 
ラーについて tt メッセージを衣示しません0 
この7ァンクシ3ンが(》’37011を通して Di»kBASIC の琢堍からコー 
ルされると、 M 御は位麻 r BREAKVECTj のアポー!•ベクタへ ili されま 
す。このでは， S«l に定龚されたユーザーのアボートルーチンはな< 
r joinj はエラーコードを返さないため、エラーコードは rBREAKVECTj 
にあるコードによって Sd •後されなければなりません。 

アボート終了ノ上ーチンの定義 

(_檐能# ゆ I 63H(DEFAB) 

[3 -ル手順 '] DE アボート終/ルーチンのアト•レス 
000 0 H で定疾解除 



「戻 リ f£ ] A 0エラーを生成•しない 

I W 说丨 この7ァンクシ3ンは MSX D_S の典堍で M05H 番地を通して: 》- ル 

されたと S に利刖できます。 Disk BASIC の K 垵で 0F37DH を通して fi 
コールできません • 

DE レジスタが0であると，前に定 IS したアボートルーチンが! t 在を W 
松され、そうでないと新しいものが宅莪されます。000 0H 推•地に苗接ジャ 
ンブするのではなく.外部ブ〇グラムがなんらかの W 由で ft 了しようとし 
ているときには必ずシステムによってアボートルーチンがコールされます • 
MSX DOS2 のために？ F かれたブ〇グラムでは、000 0H 番地へのジャンプ 
ではなくて， 1 ■エラーコー，ドを伴った終了 j ファンクシ3ンコール （P_320 
事照）で終了しなければなりません。 

ユーザーのアボートルーチンはユーザーのスタツクをアクティブにし 
ファンクン3ンコールが行われたときと N じよつにIX, 1Y と*レジスタ 
セ y 卜をセットし. TPA 全体をベージングして起*))?れます，終/•エラー 
3- ドは A レジスタ、2次エラーコードは B レジスタでルーチンに波され. 
ルーチンが 1 "RETj を実行すると、および B レジスタに返されたが 
•■親ブロセスに；5!る j ファンクシ*ン （P.318* 照）で返されるべきエラー 
コードとしてストアされ，通常コマンドインタ-■ブリタによって出力され 
ます。あるいは，ルーチンはリターンせずに外部ブログラム屮のなんらか 
のウォームスタートコードにジャンプしてもかまいません • システム li •起 
全(二安定した状®にあって、どのようなファンクションコールも受け付け 
ることができます。 

A レ•ンスタに入れてルーチン1こ液される1次エラーコー Kli, ブログラ 
ム自身が r エラー:ドを伴った柊了 j フアンクシ3ン （P.320 参照）に;* 
した： J— ド （0 でもよい）になリ il (これが ft 了の tt 由ならば)， 

[tTRq + lCj あるいは ICTRLl + ISTOPl か梢知された坳含 (「.CTRLC 
j または r .STOPj エラー）、ヂィスクエラーがアボートされた場介 （ 
f.ABORTj エラー)、あるいは MSX DOS のフアンクシ s ンコール OlH 
~0*H を)*してアクセスしている «_'f» 人力あるいは出力のチャンネルのひ 
とっでエラーが起：った場合 CJNERRj または r .OUTERRj) にもルー 
チンは3—ルされます • r.ABOHTj, MNERRj . および r .OUTERRj 
エラーはなんらかの他のエラーの ttilt としてシステムによって生成されま 
す。例之ぱ， r .ABORTj エラーは r.NRDYj エラーによって起こる可能 
性があり. MNERRj エラーは r .EOFj エラーで起こる吋能性がありま 
す。これらの場合には、元のエラーコード （「.NRDYj や r .EOFj) 112 
次エラーコードとして B レジスタでアボートルーチンに尥されます。その 
他のすべてのエラーは2次エラーコードを持たず、 B レジスタは0です= 
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アポートルーチンが Hi 純にリターンせず， TOP HI, : RETj (または同 
等のコード）を文行すると.制御はエラーが起こった MSX »0S 3- ルま 
たは BIOS コールのすぐ次の命令に®ります。これは•■ディスクエラー処 
理ルーチンの定義」ファンクション （P.322 参照）とともに使用すると冇 WI 
で，デイスクエラーが起こったときに现 fr. の MSX-DOS コー/レをァボー 
卜することが可能になリます • 


ディスク エラー 処理 ルー チンの定寒 

I 檐能# W I 64H(.»EFEH) 

Iコール f 期] DE デイスクエラールーチンのアトレス 

000 0H で定*解除 

I圾り ffi I A 0エラーを i 成しない 

[解说I このファンクシ3ン li ディスクエラーが起こった場合•にコールされる 

ユーザーのルーチンのアドレスを析定します。 TPA 全体をページングして 
ルーチンは起 W3 れますが、ページ3のシステムスタックが7•クテイブ(こ 
なり、 MSX DOS の 7T ンクシ3ンコールが其彳Iされたときのレジスタは 
保存 S れません， 

エラールーチ〆は MSX-DOS の3—ルを实行できますが.エラーの洱 
W を进けるように十分 ELS： しなければなりません •17.2 •■ファンクン3ン 
一资 J はユーザーのエラールーチンからどのファンクシ3ンコールが安全 
に•大行できるかを示しています-標華人出カチャン冬ルがリダイレクトさ 
れている場台•には、このルーチンはリダイレクション状態を一時的に無効 
にした状班でコールされます。これについての詳細は、「リダイレクション 
状»の®褂•セット j ファンクション （P.329) を麥照して下さい • 

ルーチン自体のパラメータと铭果の fi 様を下に示します。IX, IY および 
a レジスタセットを含むすべてのレジスタは破«できますが，ページング 
とスタックは保存しなければなりません，ルーチンはシステムIこ返らねば 
ならず、外部プログラムを絞行するため!こ別のところにジャンプ t てはな 
9ません.これを行うに A=1(• ■アボート J> を返すことで，ユーザー 
のアボートルーチンに制御を推して、アボートルーチン内で必要な理を 
tr うようにします。 


17.3 フアンクシ 3 ンの; lii 明 
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バラメータ A =エラーの原 W となったエラーコード 
B =物埤ドライプ 
C =bO 方き込みでセット 

=bl 無视のが Vましくないときセット 
=b2 オートアボ ーI •を指示するときセ，/卜 
=b3 セクタ番号が存効のとさセット 
DE= セクタ番号 （C の b3 がセットされているとき） 
結眾 A M) =ンステムエラ—ルーチンのコール 

=1=アポート 
=2 =再试行 
=3 =無視 


直前の エラーコー ドの獲得 


[機能番 *4] 65H(J：RROR) 

|ja — ル手I明 なし 

り値 I A 0 

b iffm のファンク 3ンからのエラー 3— ド 


I解说1 このフ T ンク X3 ンによって、ユーザーブログラムは前の MSX-DOS 

7 7■ンク•〆3ンコールが失0：した埔因のエラーコードを見つけることがで 
きます。これはエラー： J — ドを返さない古い CP/M 互換のファンク：^3ン 
で使川するためのものです。例えば、 1 ■ファイル FCB の作成 j ファンクシ3 
ンが A=OFFH を返すと、失敗の理 III は数多くある能件がありますが 
このファンクションコールを使用すると、例えば 「.DRFUI,j や r.SYSXj 
など通切なものを返します。 


エラーコー ドの説明 



[コ .ー ル子*| B 龙明すべきエラーコード 

DE 64パイ t の文字列バゾフ7へのポインタ 


| 3：ラー処理 



ディスクのフォーマット 
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A=0 の*具合、 B と HL レジスタはフォーマットの捶玫を;2択する ASCIIZ 
文字列のスロット*号とアドレスをそれぞれ返します，このディスクがフォー 
マ，/卜できない（例えば RAM ディスク）と MF'ORMj エラーが返され 
ます，文字列は 「 RDSLTj ルーチンを使用して说み込ま# U 肉而に表示さ 
れて、それから r ?j ブロンブトが表示されます，ューザーはそこで r lj 
~ r 9j の遵択を指定し、この®択が r フォーマット j ファンクシ3ンに迪 
切な转告-プ〇ンブトの後で®され、劣際のディスタのフォーマ，卜が龙行 
されます。 A^O て -HL に0が返される場合•があり、これはフォーマ，/卜が 
1利 i 類しかなくプ〇ンブトの必»が無いことを S 昧します，これらの処《 
はディスクドライバごとに光なるため、それぞれの遒択がどのようなディ 
スクフォ_マットを参照するのかを知る方法はあリません， 

A=011 卜 09H の場合，これはフォ ー マットの選択として解釈され，それ 
以上のプ D ンブトなしでディスクは柑定のドライブでフォーマットされま 
す。 HL と DE レジスタはディスクドライパによって使用されるパッフ T 
領域を栴定しなければなりません，このバッファがどの位の大きさである 
べきか知る方法はないので，可能な限 U 大きくするのが 4i 良の方法です。 
パッフ r がページ境界をまたぐと、このファンクンはディスクドライ 
パに！®すために、ひとっのページ中の«大の#分を进択します。ほとんど 
のディスクドライバはこのバッファをまったく使用しません。 

A=FFH の場1年，ディスクは*眯にはフォーマットされませんがディ 
スクに析しいプートセクタを方き込み、 MSX-DOS2 ディスクにします•こ 
れは以册の MSX-DOS1 のディスクをボリューム 1D を持っように更新し 
て、それ U よって MSX DOS2 で可能な完全なディスク検2とファイルの 
饭话を可能にするためです。 A=FEI1 は A=FFH とはば吋楳ですが.デ< 
スクパラメ-■夕のみを1しく®新し、ボリューム ID でプートプログラム 
を S ね方きすることはありません-ディスクI••に不Iなブートセクタを黄 
くいくつかの MSX-DOS1 のインブリメンテーシ3ンが fr 合するためそ 
れらのディスクはこのファンクシ 3 ンで Slit されるまで MSX-D0S2 では 
使 W することがで$ません。 

1 ■プートセクタの K 新 j は上に FIXDISK コマンドのために«:けられて 
いますが，それが有用な*8合には他のブログラムで使用することがで|ま 
す。それを使用する場合には， 1 ■フォーマットの遘択の換付 j (A=0) が Wt 
初に突行されなければならず、これがエラー(油常 r .IFORMj) を返すと 

これ*<フオーマットできないドライブで.ディスクはこのファンクン3ン 
で扣侑されることがあるため、热《はアボートされなければなりません。 



RAM ディスクの作成あるいは消去 


[嫌能# V] 68H(JIAMD) 

[•3—ル子順| B OOH RAM ディスクを消: t- 

1-FEH 新しい RAM ディスクの作成 
FFH RAM ディスクのサイズを返す 

I 05 ') Wi ] A x ラー 

B RAM ディスクのサイズ 

|解说| B レジスタ =0FFH の埸 ■ft •、このル'-チンは，現在の RAM ディスクに 

別 0S てられている 1GKRAM セグメントの致を返します。倣〇は现 t 定 
«されている RAM ディスクが17在.しないことを示します。 B=0 の場合 
现1；の RAV1 ディスクが消去され、それが保待していたすベてのデータは 
失われ， RAM ディスクがなかった場介でもエラーがあされません。 

また、 B が 01H~FEH の® M にある場合、このファンクシ3ンは B レ 
ジスタに衍定された 16K セグメントの数を使用して祈しい RAM ディスク 
を作成しようとします。 HAM ディスクがすでにある場合 C.RAMDXj) 
あるいは未使 IW のセグメントがひとつもない場合 ( r ,NOIlAMj), エラー 
が返されます。指定のサイズの RAM ディスクを作成するのに十分， MS 
用 RAM セグメントがないと可能な*大のものが作成されます。この場办 
エラーは返されません， 

すべての場合において、 RAM ディスクのサイズがセグメント»として 
B レジスタに遇されます。 RAM のいくらかはファイル T ロケーシ a ンチ_ 
ブルとルートデ■(レクトりに使われるため、 DIR や CHKDSK コマンドで 
示される RAM ディスクのサイズは使用される RAM の総計よりもやや小 
さくなります-システムの ft のドライプ数に関わらず、 RAN1 ディスクは 
常にドライブ文•ナ： rH：j としてアクセスされます • 


セクタバッファの割り付け 



論理ドライブの割り当て 


|_1予一 炫理 



環境変数の獲得 


[ I ラ- fca 」 


['槻能 f|J 6BH(.GENV) 

[3 -ル HL ASCIIZ 名葫义字好へのポインタ 
DE Ol のための' 、•ッ7ァへの•十、•インタ 
B /<ッフ T サイズ 


A エラー 

DE 保存される、 A*0 の場合にパ./77■が i» たされる 


「说| この7アンクシ a ンは HL レジスタに渡された5!境変»名の現在の肮を 

播得します。 S% 金8[の人文十，小文卞の遑いは*说されます。名 tfi の文 
¥列が不I卜:であると r.iENVj エラー)^巡されます。その名前の S! 境変数 
がないとバッファにヌル文字列が返されます。その名前の変数があると- 
その ffi の文字列がバ 777■にコビーされます。 ハ*ッ7 7■が小さくて入らな 
いと，級の文字列は W 後のヌルを付けずに切リ扮てられ、 「.ELONGj エ 
ラーが返されます。他の文卞 W は255文1■■よりも C くできない （fi 後のX 
ルも含む）ため、235パイトのバッファは常に十分な大きさを持つことに 
なります。 


環境変数のセット 


1エラ-処 a 



環境変数の検索 


p [能番号 | « DH ( FENV ) 

&ール手順 , de a 境®数*号 

HL 名 W 文字列のパッフ7•へのポインタ 
B バッファサイズ 


A ェラー 

HL 保存され，へ*ッ 7 T が i » たされる 


解 议 } この7ァンクシ3ンはどのような现境変数が現 ft セットされているかを 

知るために使用されます。 DE レジスタの* ft# 号•は' リスト中のどの変数 
を検索するか（最初の*»が DE=1 に対応）を示します。変数番号 <DE> 
が存在すると、この変 ft の名前文字列が HL によつて拊されるパッフ r 中に 
3ピーされます，パッ77•が小さすぎる場合に li、 名前は较後のヌルなし 
で切 1 )搶てられ、 r J：LONGj エラーが返されます。255パイトのパ../ファ 
は、常に十分な大きさを持ちます。変れ# 3<DE> が存在しないと、ヌル 
文字列が送されます（変数はヌル名文字列を持つことはないため 


ディスク検査ステータスの獲得•セット 
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トセクタをシステムが押チ x ックするかどつかを制御します•それが有効 
であると、 to 埋の&中にディスクを交換することによって.問違ったディ 
スクに«ってアクセスすることができなくなりますが，有効でない場合•に 
はディスクを破坎する場合もあります。ディスクインタフエ ーX のタイプ 
によって男なりますが、この梭能を有効にする場合に若干余分なオーパー 
ヘッドがある場合があリます。しかし、ほとんどのタイプのディスク（ディ 
スク交換を検知するためのハードウェアを持つもの）では*4理時間に変わ 
りはなく、これによって安全性が ff 保されます。 


MSX — DOS のバージョン番号の獲得 | jc ラ-処理 J 


[梭能# I 6FH(_DOSVER) 


[§_ ル手順 j なし 


页り ffi , A エラー (3R に 0) 

BC MSX—DOS のカーネルパージョン 
DE MSXD0S2.SYS のパージョン恭 -SJ- 


(_ 解说 I このファンクションによって、プログラムは*行されている MSX-DOS 

のバージョンを刊断することがで S ます • 2つのパージ》ン S 号が iS され 
BC レジスタに ROM 屮の MSX-DOS の々■■ネルバージ a ンが、 DE レジ 
スタに MSXDOS2.SYS システムファイルの/«-ジ3ンが入ります,これ 
らのパージョン番号のどちらも上位バイトに生ハ•ージョン番号、下位パイ 
卜に2桁のパージョン#号が BCD (A で入っています，例えばパージ3ン 
2.34 のシステムが存在したとすると、これは0234 H として衣現されます。 

MSX-DOS1 との互換性のために、次の手順がこのファンクシ a ンを使 
用するためには必要です。まず、エラーが存在する （A<>0> と、これは 
MSX DOS ではありません，次に B レジスタに注目します，これが2以 
下であると、システムは 2.00 より以前のもので、 C と DE レジスタは不 
定となります。 B レジスタが2以上の場合、 BC と DE レジスタは上記の 
ように使用することができます。通常この手®の後、チ*ックされなけれ 
ばならない■ージ》ン番号は、 DE レジスタ中の MSXDOS2.SYS のパー 
ジョンです。 



リダイレクシヨ ンの 状態の獲得 •セットラ-腿| 


■機能# V 70H(JIEDIR) 


[コール 子順 I k 00H リダイレクシ s ン状®の}«得 

01H リダイレクション状®のセット 
B 新しぃ状 S 
bO «咿人力 
bl 出力 


戾リ ffi | A エラー 

… B コマンド以 M のりダイレクシ S ンの状 S 

bO セ y 卜入力がリダイレクトされている 
bl セット出力がリダイレクトされている 


[解说丨 このフ7•ンクションは生にディスクエラールーチンや、リダイレクション 

に W 係なくコンソールに常に出力されなければならないその他の文字 I/O 
のために提供されています。 CP/M 文字フ7•ンクシ3ン（ファンクシ a ン 
01H-0BH) が使用されると、それらは通*コンソールを参照します•し 
かし、標準入力あるいは樣準出カファイルハンドル（フ r イルハンドル0 
および 1) がクローズされてディスクフ7•イルに再オーブンされていると、 
CP/M 文字フ7•ンクン3ンもディスクフ r イルへ比さされます。しかし 
ディスクエラー出力などのある®の出力はそれに開保なく常に W 而に出力 
する必要があリます。 

i のフ r ンクン s ンによって、このようなリダイレクシ*ンをこのフ t 
ンクシ a ンを A=1 および B=0 としてコールすることによって一時的に無 
効にすることができます。このファンクションをコールすることで、以降 
の CP/M のコンソール I/O がすべてコンソールに出力されることが保证 
され.また、 ®.iW の奴定が返されるためこれを後でリストアすることがで 
きます，このようにリダイレクシ a ンの状®を変更すると、システムは幾 
分不安定な状®となり、多くのフ 7 •ンクシ 3 ン 3 —ルがこのファンクショ 
ンを無効にしてリダイレクションをその実®の状®にリセットします。通 
常、「オーブン』、—ズ J 、 r ft58j などといった、フ 7 •イルハントル 
を提作するすべてのフ 7 •ンクシ 3 ンコールはリダイレクシ 3 ンの•执想を 
セットします。したがってこのファンクションの効果は完全に一時的なも 
のです • 




MSXView とは 


MSXView とは、ユーザーインターフェイスに優れたアブ IJ ケーシ a ンプログラムを容 S 
に Bfl 発するためのグラフイカルユーザーインターフ i イス•✓ステムです。 MSXView に対応 
することで， MSX turbo R 用のアブリケーシ9ンブログラムの明薄の作* fi を大 M に減ら 
すことができます 

1.1 開発者にとっての MSXView 


従来 MSX turbo 只では，それぞれのアプリケーシ a ンブログラムがボインティングデパ 
イスの管理を行ったり、かな漢字変換•ノステムや漢字フォントを内*していました • 

しかし、 MSXView の環境でアブリケーシ s ンブログラムを作成することにより、これら 
のシステムリソース（ンステム««>をおのおののアプリケーン 3 ンブ13グラムが管理する 
必要がないため、従来と比較してアプリケーレ9ン明«作龙が•人*8に緩和されます， 

さらに、アプリケ■ジョンを MSXView の規定にしたがって作成すれば、将来に浊りさま 
ざまな恩*が受けられることになります。ポインティングデバイスの管理、かな*字変換、 
デスクアクセサリ、各種フォント資猓字、デザイン文字など）などのシステム炎®につ 
いて、ハードウ*アに変 E があっても、 MSXView がその遑いを吸収するのでアプリケー 
シ9ンはほとんど91にすることなく開舞に集中できます。 


1.2 ユーザーに とっての MSXView 
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第二に，アプリケーシ3ン間でのデータの受渡しを円滑に行えます。これにより、あるア 
プリケーレョンで作成したデータを別のアブリケーシ3ンで利 W することができ、一*コン 
ビュータに入力したデータが無駐になりません， 



MSXView ファンクシ 3 ンの使い方 


MSXView の構成と機能 


MSXView は次に示すようなマネージャ辟によ成されています • 


• デイスブレイマネージャ 
• ビットブロックマネージャ 
• グラフック 
• フ#ントツク 
•テキストマネージャ 
• リ、/ースマネージャ 
•イベントマネ—ジャ 
•コントロールマネージャ 
• メニューマネ--ジャ 
• ダイアログマネージャ 
• プリントマネージャ 


この章では、これらのマネージャについて说明します。 


3.1 ディスプレイマネージヤ 



シャによって約に待;®されるので、冉«_などを ii •う必 Sli あ*)ません，ただし、盪ね 
られるウィ■••トウの ia«t こ制限があります • 

油常の描阀»域には Fwm を、ボ y プア. •/ ブメニューなど注 B させたい部分には SWIN 
BW1N を他うことを推熒します。また，通常のウィンドウは、その総面稍に限りがあるため， 
FIX ウィント•ウという移觔やオーパーラップがで$ないウィンドウを使用することができま 
す- ft アブ _) ケーシ S ンの描 W 領域、作**域な K 大きな而稂を使 ffl する®分をウィンドウ 
で轮押するには、 FIX ウィンドウが便利です。 FIX ウィンドウ問十を a ねあうことはできま 
せんが. FIX ウィンドウと通常のウィンドウ （FLOAT ウィンドウと呼ぶ）を相*I:に f ねあ 
うことはできます。 

3.2 ビットブロックマネージャ 

t ノトプ〇ソクマネージャは、ウィンドウ热理を，泛速化するために、 wifiih の矩形蘭域を 
効率的に J6VRAM に格納するための7ネージャです，オーメ'{ーラ y ブウィント•ウの再描 I® 
热戊をアブリケーシ9ンか行わなくても良いのは， t.y I•プロックマネージャが、除される 
部分を自助的に*1内商に待避するからです-ビットブロックマネージャでは、 t§ 形領城を« 
に1ラインずつXライスし、上から摩!に格納しています《 

MS、K y トブロ y クマネージャは.ウィン！••ウ苷 ffi の内部処理ルーチンとしてディスプ 
レイマネージャから利用されいますが，両像を扱> アプリケーションなどで iff}*； 利 HI するこ 
ともで5ます。 

3.3 グラフノぐンク 

グラフパックは、グラフィックスの iJL 用ルーチン群です。描阀5{境を汶定し，点. S 躲，四 
角形、 pi 、 掊 ra. 祕. 多角形などを®逢に描内します，このと s に、ペン先や! e りつふ*し 
タイルの推定.クリッビング頷《なども拆定できます， 

グラフバックを使用するには、描® S 垃 （MSX View ではペンと呼ぶ）を;®定しなければ 
なりません， 

システムで [i、SYSPEN と呼ばれる標準 W な描画*8境を ra® しているので.通常の描两| 
に (i この SYSPEN •を ft います，しかし，太いペン先や特殊な金りつぶしタイルなどの袼 a 
な描刺5!*を使うと S は，アプリケーシ9ンでペンを作成し、それを使用します。 SYSPEN 
を勝手に史新すると、以降のアプリケーションおよびシステムサービスの実行に大きな影 W 
を及 (3： してしまいます。 

MSXView では、 PI 時に) ka のペンを作成しておくことができます。使 ra 中のペンを々レ 
ントベンと呼び、他のペンを使用するときには、々レントペンを切り換えます- 

グラフパックの使用する座 ff 茅、は、すべてウィ〆ドウの8[点（ウィン！••ウの左上の点}か 
らの +B 対®揉です-したがって、ウィント•ウをどの場所に出しても、内部の描幽処理につい 
ては、気にする €•* はありません。 
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また、グラフ/<ックでは、グラフィックアプリケーションのために、ある点が直線や円の 
h に存在するかどうかを: H ベるための植能があります。この®能により、描いた図形をつか 
む ttffi などが簡电に紀述できます。 

3.4 フォントパック 

フォントパックは、文字を出力ためのルーチン辟です。 ttft の3鉍、大きさのフォントを 
サポートし、さまざまな飾りっけ（太字、斜体.铪郛、彩、捣など）をすることができます。 

MSXView では，茁ギコ ーI ••としてシフト JIS コードを採用しています。これによリ、 MS- 
D(〕S マシンと文*データを交換することができます- 

文字の«餘は、フォントテンプレートと呼ばれるデータで»»されています。 

システムでは、 SY.SFONT と呼ばれる棵準的な文字描幽環項を用意しているので、通常の 
义字表ボでは SYSFONT を使います。しかし、アプリケーションで待味な文字を使用する除 
には、アプリケージ s ンでフォントテンプレートを作成し、それを使うようにしてドさい， 
SYSFONT を勝手に E 新すると、以降のアブリケーシ3ンおよびシステムサービスの実行に 
大きな彩零を及ぼしてしまいます。 

また* MSXView では， I5IM •に»数のフォン！•を作戌してお < ことができます，使 W 巾の 
フォントを々レン！•フォントと呼びます.他のフォントを使うときは、勿レント7ォントを 
切り換えて使用します， 

フォントパックの俾 Hit る庄標系 d グラフパックと Rt く、すべてウィンドウの取点（ウィ 
ンドウの左上の点）からの相対座標です。したがって、ウィンドウをどの場?斤に川しても， 
内*の描画処押については、考瓛する必要はありません。 

MSXView 麻字 ROM 力一!'リヴジ«、12x12、 12x8 の2»級の*宇フォントを内茂して 
います（本体に内*している檐«もある） • その他に、ディスク上にフォントを持つことも 
できるようになっています。 MSXView のシステムディスクには、標準でデザインフ1•ント 
4«類が入っています。フォントパックではこれらのすべてを使うことができます。外字に 
ついては、 GAIJI.MV というファイルに 2SM のサイズの外字が保存されています。 


3.5 テキストマネージヤ 


テキストマネージャは，文字列の入力と表示を管理します，日本话入力も自_に si 理す 
ることが可能です。 MSXView で文字列の入力を行うときには、テキストマネージャを使用 
します。テキストマネージャでは、 H1 ■•だけの入力や®数行の入力だけでなく、場 A ■によっ 
てはXクロールするような大 fi の文字列を人力することもできます • 

テキスト <>7ォントやペンと同じく梅数作成しておくことができ、その内1つがカレント 
テキストと呼ばれます • キーボード《1つしかないので、キーからの人力は必ずカレントテ 
キストに対しての入力とみなして処理されます。 

文字列は、原則としてキーボート•を使用して行うようになっていますが，マウスなど 
のボインテイングデバイスを使うこともサ®されており、コント n —ルマネージャと併用し 
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て、マウスによる力 一V ル U 茜のや、傾城指定が描単に行えます。 

また、いくつかの文字列から1つを選ぶというアイテムセレクタについても，テキストマ 
ネージャを使用することにより、非常に簡单に作成できます。例えば、 VSHELL ではフ T イ 
ル選択、プリンタ選択などで、テキストマネー•ジャによるアイテムセレクタを使っています。 

3.6 リソースマネージヤ 

リソースマネージャは、ファイルの管理を行うマネージャです。 MSX.-DOS 现境では手間 
のかかるエラー热理などもサポートしています。 

また、通常の MSX DOS フ7■イルシステムの呼び出し機能の他に、最大 6，1K バイI•のファ 
イルノ<>>フ7•を探作できるファイルアロケータを管理する梭能も備えています。 MSXVit-w 
では、アブリケーシ3ンェリアが最大 32K パイトなので、大きなデータは、ファイルア〇 
ケータを使用して、テ•ィスク上に取らなければなりません。 

また、オーパーレイプログラムの実行をサボ-■卜するための榱能も、リソ _X マネージャ 
の管理下にあります。 

3.7 イベント マネー ジヤ 

イベントマネージャは、システムに対する外部からの人力（キーポード、ポインティング 
デパイスなど〉を管理し.これらをイベン！•として扱うマネージャです。 MSXView では、ア 
プリケーシ9ンの助作は，外部からのイベント（キーボードからの人力やポインティングデ 
ペイスのポタン搡作など）によって起觔されます。 

また、イベントマネージャは、刺り込み)！! i 理を使って、ポインティングデパイスの铳み込 
みを行い、これによ0移動するマウスカーソルの表示*！*を行います。したがって、アブリ 
ケーシ a ンではマウスカーソルの管理、表示について！(Iにする必要はありません。 

マウスカーソルは、聚大 16x16 ドットの任意の八ターンが使用できます。色は2色使えま 
す，マウスカ ーV ルの形状は flk 大12個まで®»でき、そのうち2つは、システムで予約さ 
れています • 

マウスカーソル番号3番以降は、アブリケーシ a ンか自由な形状を荆り当てて使うことが 
できます。また，領域を指定しておけば、指定された領域に入ったときだけ々"■ソルのバター 
ンを史える棰能 fc あり、«大16個の領域を指定しておくことができます。マウスカーソル 
は割り込み热理で自動的に描かれ、指定された領域に入ったら、自勒的に指定された形状に 
変化します。 

イベントは、イベントレコードという形で、システムが管理するイベントキューにためら 
れるようになっています。アブリケージ3ンは、必要に応じてイベントマネ'-ジャを呼び出 
し、イベントレコ- ■! ••をもらい、そのイベントの種類別に分岐して、イベントの趄理を行う 
のか一般的です。イベントレコードには、そのイベントが生じたときの 「SHIFfl キーなどの 
状想やマウスカ■•ソルの位 S が保存されているので，必要な悄银 U とんどの場合、イぺ 
ントレコードから得ることができます。 



し、岡時に点滅するウィンカは1っだけです， 

テキストマネージャを使用する埸合には、テキストカーソルとしてウインカを打觔れに a 
定するので、アプリヶーシ3ンは何もする必要はありません，_ 

_イベント マネー ジャでは、マウスを持っていない人のために、| GRAPH] + fSELECT] キー. 
「STOPI キー、カーソルキー (I t IK ||*-||-*|)を押すことにより，マウスの 1st ボタンと 
2 nd ボタン、移動をシミュレートできるようになっています。 

3.8 コントロールマネージヤ 

コント CJ— ルマネージャは、画面に表示されるさまざまなコントロール（ツマミ類）を管 
理するマネージャです，コントロールとは、例えば両面に表示されるボタン、チ*ックマー 
ク、スク〇_ルパーなどのもので、このマネージャを便用することにより、これらの音 1 理を 
容 S にかっ効串的に行うことができます。 

コントロールを使用するには、コントロールテンブレートというデータ構适に基づいて、 
データを作 I& しておかなければなりません，コントロールテンプレートには、コントロール 
の種®と状®、位 S (ローカル座«!>、大きさなどが格納されます，このコントロールテン 
ブレ-■卜を用®しておくと、コントロールの表示やマウス々ーソルの位 E を指定した： J ント 
口ールの検索、実限のコントロールの動作処》などが简*に紀述できます。 

また、アブリケーシ3ンで特殊なコント〇••ル（ツマミ〉を作成し、2錄することもでき 
ます。 MSXView では、これを々スタムコントロールと呼んでいます。この場合は、コント 
ロールドライパというモジュールを MSXView のルールにしたがって作成し、そのエントリ 
を茕錄しなければなりません。 

3.9 メニューマネージャ 

メニューマネージャは、文宇列メニューを音 1 理するマネージャです。通常のアブリケーシ3 
ン開発では、ューザーが扱いやすいメニューの管理はたいへん面倒です。 MSXView では、 
メニュー内に表示する文宇列を所定のデータ形式で龙ベるだけで、メニューの大きさや Kg 
にいたるまで、メニューマネージャが管理します。メニ:！■一はポインティングデバイスを使 
用してもキー； K- ドを使用しても簡电に迸択で S るようになっています。 

メニュ'■'マネージャでは、ブルダウンメニュー、ポップアップメニュ■'などの各種メニュー 
を讶坪することができます。 



甩則としてメニューは、视在の*ーソル位 a を中心とした位 a に表示され、横は幽面いっ 
ぱいに、縦はメニューパーに重ならないよう、18ドットから211ドットまでに自觔的に制限 
されます。闽定位 s に出現するよつにすることもできます。ボップア y プメニューの大きさ 
は、メニューテンプレートの内容により、自觔的に玷小の大きさに設定されます。 

メニューの表示内容は、基本的には文字列て is 成されます。また、メニュ•■をキーボード 
を使ってワンタッチで$択できるようにするため、メニューの要*ごとにキーコードが指定 
できます。 


3.10 ダイアログマネージャ 

ダイアログマネージャは、ユーザーとの対话を皆理するマネージャです。一定のデータを 
用®しておくだけで、ユーザーからのイベントを A 動的に S けつけ、热*を行います•ダイ 
ア〇グマネージャを使うことにより、コント〇—/レマネ_ジャのいがよリ前电にな9ます， 

3.11 プリントマネージャ 

MSXView では、サポートしているプリンタごとに、プリンタ！••ライパという特殊なオー 
パーレイモジュールが用意されています。これにより.すべてのプリンタを 「MSXView 仮 
S プリンタ j として統一的に扱うことができ、ブリンタの秘類ごとに別々のブログラムを明 
発していた«£米の方达に比べて、大変簡蝌に各 S のプリンタをサボー！•することができます， 
基本的には、 VRAM にイメージ情報を展開し、これをブリンタドライバに*して、案際 
に印宇を行うという手唯になります • 

3.12 その他のマネージャ 


MSXView には，以上で簡単に说明したマネージャの他にも、 H 下のようなマネージャが 
あります。 

• システムマネージャ 
• キーマップマネージャ 
• サウンドマネージャ 
• メモリマネージャ 
• ブリンI■マネージャ 




ハンドルの 概念 


MSXView では、さまざまなマネージャでのデータブロックの指定に.ハンドルと呼ばれ 
るデ'-夕«逋を®)«しています。ハン！■•ル li 1パイトの® ft で表现され、その番号によ 1 )、 
以 F の意味があります。 

U 3.1 ハンドルの S 眛 

ハンドル*号38味 

0 ハンドルの番号としては使用しません， 
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溶 4 家ハンドルの概念 


テキストテンプレート（文字列 te* の5?谢 
フ7•イル 

メニュ ー 
3ントロ-ル 
ウイン* 


MSXView で11、ハンドル管理されているデータブ〇ックは、すべてシステムエリアに规 
定焖«のデータエリアが用.®されています。したがって、アブリケーシ3ンが各種のテンブ 
レートとして、大きなデータブ〇ックをいくっも*する必要はありません。 

ハンドル苷理を行うことにより、大 S のデ_夕を1バイトで抱定できるので、 ftt なアブ 
りケーン s ンプログラム領域を無 K 使いすることなぐブ〇グラムの才-•パーレイなどを行っ 
ても、データの位两を氕にすることなく開発することができます. 




弓章 

AP の標準レイアウト 


アブリケーシ ■ ンの画面レイアウトは、 MSXView z ステムの全体的な抹一化のために特 
に不都合のないかぎ9以下の形式にして下さい。 

これに±9,ユーザーはある1つのアプリケーシ■ンの基本«作を*えてしまえば、他の 
新しいアプリケーン s ンも_理な<使えるようになるというメリヴトが生まれます。 


5.1 タイトルパー 

ファイル処理、卬刷、終了などのメニューが人っています。また.現在《集中のフ7•イル 
名の衣示も行います， *8 集中のファイルが新規作成中の場合には、「新規」と表示されます。 
ここに人るメニューの内容は以下のようなものです • 


表 3*2 タイトルパーの内容 

内?？ 《味 

新規 钃窠内容を《棄して初期状想にします， 

保存 内容に名拥をつけて保存します。 

E 新 編生内祥を玫み込んだときの名筋で保存します， 

统込 保存してあったデ'-夕をディスクからみ込みます， 

登録 標準形式のデータ交換ファイルを作9ます • 

組込 標準形式のデ—夕交換フ7■イルを組み込みます • 

印刷 印刷を行います • 

印刷形式印刷形式を設定します， 

終了 アブ IJ ケーシ s ンを終了し、 VSHELL に戻ります。 


第 5®AP の橡求レイアウト 


5.2 DA バー 

デスクアクセサリメニューが A つています。 

5.3 コマンドパー 

アブリケーシ a ンの各メニューが入っています。この部分のメニューはアプリケーシ3ン 
(二よって異なります。 


IVSHELL 1.0| @ _ 龉穌脷 


£ 


^0. 





6 章 

操作における規定事項 

この章で li 、MSXView 用のアブリケー vs ンを M5S するにあたって、投作面で守らなけ 
れぱならないことを说明します。 

6.1 操作方法 

文字の入力以外はマウスのみで揲作可能にして下さい。また、すべての操作をキーボード 
上からも行えるように K 慮して下さい。 

6.2 デスクアクセサリ 

ほとんどの状想でデスクアクセサリが起 W できなくてはいけません， 

6.3 特殊キー 

フ r ンクシ s ンキーやグラフキーのような特殊キーは、以下のように«リ付けます， 

(JI]~[Flo! _ コマンドパーの左から*に#10付けます。 

[GRAPH 頻繁に使う機姥を割り付けます。 

6.4 印刷 


印 tf) については、 MSXView で定められている仮想プリ/夕を対象にブログラムを作成し 
ます。1つ1つのブリンタの差は、 MSXView で用竞されている各種のプリンタドライバに 
よって哦収されるので、多»のブリンタを対象にブログラムを開発する必要はありません。 


ファイル名の入力 



ファイルの形式 


この章では、 MSXVlew のフ7•イル形式について说_します。 

7.1 アプリケーションファイル 

アブリケーシ3ンファイルは，先®からアブリケーシ》ンエリアに»み込まれるパイナり 
7 7•イルでなければなりません，さらに、オーパーレイモジ i ールを含むアブリケーシ3ン 
の場合には、ファイルの後ろにオーパーレイモジュールが遑結されていなければなりません， 

7.2 データファイル 

アブリケージョンが作成するデークフ7•イルの形式は自由です，したがって、どのような 
7才ーマッI•でフ T イルを作®してもかまいません。また^他のアブリケーシ s ンや MSXView 
以外の各種アブリケーシ s ンとデータの互換性を持たせるために、複数のファイルフォ•■マツ 
卜をサポートすることもできます。この場合には、タイトルパーの中に、ファイル形式変 E 
のメニューがなければなりません， 

また、データファイルの中にはユーザーが作成したデータの他に、そのデータが保存され 
たときのアプリケーションの状態を示すデータを入れておくと便利です，例えば、表示形式 
や表示位8、パレット、タイル、ペンの形などが保存されていれば、そのファイルを tt み込む 
だけで、保存したときと同じ作業状態になるので、ューザーがすぐに仕事にとりかかれます • 
ただし， MSXVfcw では、枚数アプリケーシ3ン M でのデ_•夕の互換性を保証するため， 
「登録」、 1 ■組込 j コマンドで、 MSXView 樣準データフォーマットに基づくファイルが作成 
できなければなりません. MSXView« 準データフォ〜マットについては、10章 「MSXView 
樣準デ_夕』を参照して下さい， 


8 章 

オーバーレイブログラムの作成 


MSXView •✓ステムでは.アブリケーシ a ンIリアが 32K パイトなので、はとんどのアブ 
リケーシ a ンブ n グラムは、オーパ_レイブログラムを用いることになります • MSXView 
では、才ーパ_レイブログラムを別のフ T イルに fi しないで、アブリケーシ3ンの实行形式 
7?■イルの後ろに、オーバーレイモジュールを付加するというファイル構造をとっています。 
したがって、アブリケーシ s ンを1つの77•イルとして扱えるようになっています，このた 
■、才ーパーレノ事V ル*•作!》した後、，/ V7 ■ —〆✓ 〇グラムとオー/< 一 I■モ 
ジュールを1つのフ7•イルにまとめなければなりません. 

また、アブリケーシ9ンを狡計するときに、どの部分をオーバーレイモジュールにするか 
で、 ffl 発効率やメンテナンスの手間が大幅に変わってきます。 S 叶時には十分に検討して下 
さい， 

才_パ_レイモジュールは以下の事項にそって作成します， 

1 . 独立性 

2 . 単機能 


8.1 独立性 


オーノ <- レイで弗常に困難なのが常駐部とのリンクです。なるべくなら、リンクをしなく 
ても助くようなオー ■*«- レイモジュールを作成することがよいでしよう。その方が保守性が 
よく、いろいろなアプリケー; -a ンで共通に使うことができます • 

ただし、ユーザーインターフ x イスの部分は常«部に入れておかないと、ユーザーへのリ 
アクションが其早く行えません。この部分は、できるだけオーパーレイにはしないで下さい。 
例えは、ボタンを押して強調印字するのは常駐部で、その後の実際の機能（热理）はオーパー 
レイにします，ユーザーがボタンを押したら、それに対するリアクン s ンがすぐに返らなく 
ては、使い心地の良いアブリケーシ s ンにはな*)ません， 


354 


第 8 章オーパーレイプログラムの作成 


8.2 単機能 

オーパ-レイモジュールは、できるだけ棰能ごとに小さく分制することを推奨します。 

1つのオーパ'-レイモジュールにたくさんの檐能を持たせ大きくすると、ユーザ- t 6<1 つ 
の棰能しか利用しないときでも、バッファが大量に取られ、メモリの使 W 効率が低 T ■するか 
らです- 

しかし、 ユーザーの必要としない檐能までバッファに入ることが問超なのですから、その 
ときに絶対に必要とする楢能ならば《»の璣能を入れた方が良いでしよう。 



MSXView 基本データ構造 


この章では、 Msxvicw 基本データ* e について a 明します， 


9.1 1バイト型の別名定義と定数名 

1パイト s の別名定義と定 a 名は、次のように定典されています。 

TINY char /* 0-255 を表す数 


•define BOOL char 

#define TRUE 1 

«defins FALSE 0 


〆* 綸理 S */ 

/* (*FALSE) ではなく (IFALSE) •/ 
/* c sa の綸理式の at に対応*/ 


Wefine STATUS char /* 成功* 失敗® •/ 

#define OK 0 
tdetine ERROR Oxff 


•define HANDLE char 
^define NEW (char)O 
*define ROOIBD 1 
Wafine SY3PEN 1 
•define BDPEN 2 
•define SYSFONT 1 


•define COLOR cliar 


/* ハンドル型*/ 

/* 新規ハンドルの割!）当て要求 ■/ 
/* ルートポ ーP */ 

/* 樣準ペン*/ 

/* ルートボードのペン*/ 

/* 標準フ+ント */ 


9.2 基本的な構造体 


ディスプレイマネージャの構造体 


1:の -y ス哫ぺフン* 
ぅウロウ ;w トトぺフ 
oi ドブドパルルトト 
ントンーォオンン 
IT ィツィ〇フフレレ 
,u ウビウグデデ々力 


口し// ーク £* 
ブな**い -y I二 

卜も L 枠九デきき 
ツにな«のン付付 
ビな： S |角イ釤釤 


_winblock 3 aLraadsfpedeffi'curf 
lletDLEDLEDLEDLELE 

s tru 1 TIN YroHANDi HANOWI N; 


har)char)schar)rs 


raTWICWINFWINRUINIUINSUINBWI 

ineinelneinalneinsinel 


ビットブロックマネージャの構造体 






イベントマネージャの構造体 



グラフパックの構造体 

ックで使用する構造体は、次のように宣言されています。 


struct _rgb { 
TIMY r«d; 
TINY green; 
TINY blue： 
RGB; 


/* 

/* 

/* 


パレ 7 卜の色播定などで使用す 4 


o-r */ 

0-7 •/ 

0-7 •/ 


TINY 

COLOR 


-tile ■( 


off ； 


patfe] i 


/* 

/* 

/* 

/* 

/* 

/* 


PEM 栂造体のためのサブ僕造 t 本 


色づけに明する指定*/ 
pat の on ドットの色*/ 
pat の off ドットの色 


8 X8のビットパターン 
TILE.SV の意味は次のとお9 




.grafpen { 
line[4]; 




/* 

/* 

/* 

/* 

/* 


文宇以外の描闽の基本となる 
ラインスタイル*/ 


pat 内のどのドットを中心！* M 
とするかを指定(〇~7) 
pat (ペン先）のサイズを指定 







TILE_sw で使用する定数は.次のように定義 S れています。 


TILE . SW に指定する定数 


Mefina ONDOT (char)32 
Vdefine OFFOOT (char)16 


/* on ドツ ■ ■'功*/ 

/* off ドット有功*/ 

/• 冇効でないドットは透明扱い*/ 
/* (0ND0TI0FF00T) は2色タイル*/ 
/* s»»0 なら on 色のベタ塗り*/ 


9.7 フォントパックの 構造体 


フォントパックの構造体は、次のように S3 されています。 




TINY 

TIHY 

TINY 

COLOR 

TINY 

COLOR 

TINY 

TINY 

FONT? 


_font { 
id; 



shadouc[4]; 
outlinec(4] : 





/* フォントテンブレー!'*/ 

/* フォント10 */ 

/* サイズ横ドット» •/ 

/* サイズ«ドット a */ 

〆*太字棋ドット数*〆 
/* 太字縱ドット》 */ 

/* 斜体(0~32) •/ 

/• 影の数 (0-4) */ 

/* 釤の色*/ 

/* ♦&« の数(0~4) *〆 
/* 輪郭の fc */ 

/* 下嫌の fe (0 は下嫌なし）*〆 
/* « •/ 

〆*文字色*〆 
/* 未使用" 

/* 文字 W *〆 
/* 未使用*〆 

/* ビット7~ビット4 未使用*/ 

/* ビット3 ンフト JIS 禁止*/ 

/* ビット2プロボ— 〆 3ナル袋止*/ 
/* ピット1文字の回転*/ 

/* e ット〇 » 






■fntnsg { 
s JUght ; 
t.hight; 


/* 直前の文字の情報*/ 

/* 元文字のペースライン*/ 
/* 元文字の width 
/* 元文字の hight */ 

/* 実際のベースライン*/ 
〆*実探の width */ 

/* 実際の bight */ 





TIHY d.hase; 
TI«Y d_«idtb 
TIHY d_hight 
TINY f_pitch 
TINY b_pitch 
FNTMSG; 


/• »リつけ後のベースライン*/ 
/* 飾 1 )つけ後の width */ 

/* 飾りつけ後の hight */ 

/* 左にはみだすドット**/ 

/* 心にはみだす P ット R */ 


9.8 テキストマネージャの構造体 


テキストマネージャの構造体は、次のように3れています。 




HANDLE 

HANDLE 













〆*テキ又トテンプレート*〆 
/* 所 K するウインドウ*/ 

/« 〇—* ル if 授 */ 

/* テキストパッ "7 T */ 

/* テキストパッ77■の fe さ •/ 
/* 各枝オプション*/ 

/« フォン h •/ 

/* 行 a (〇は無制限）*/ 

；：::; 

/* 表示中の 5t 頭行*/ 

/* カーソル位 a */ 

/• 力ーソルの；座標*/ 
/* カーソルの逋理ゞ座標*/ 
/* 迸択範明の 5t 頭 <7 
/. 選択範囲の終端*/ 


9.9 メニューマネージャの構造体 


メニューマネージャの構造体は、次のように耷 S されています， 


typadef 





POPUP： 


.popup { 




/* ボップアップテンプレート*/ 
/* ft 秤スイッチ*/ 

/* シヨートカットキーの析定 */ 
/* 項目名文字列 •/ 




/* メニューテンプレート*/ 

/* 扑神スイッチ*/ 

/* シ3 — |•办ットキーの指定*/ 
/* 項 B 名文字列 

/* *択時に突行するポップア》ブ 





TINY 

TIHY 

TINY 


COMMAND; 


/• メニュ ー、 ダイアログなどの迸択結栗*/ 

/* メニ i ーハンドル*/ 

/* これらの項 H は関数によって*/ 

/• 盘味が興なるので U.JS が必要*/ 


9.9.1 POPUP head および MENU head に設定する定数 

POPURhrwi および MENU_head に g 定する定数は、次のよつに定在されています。 


(define CHK 
Vdefina MSK 
•define DIS 
#define LIN 
#define CEN 
#define BLD 
#define CNT 
#defln* FIN 
•define NON 


(char )128 
(char)64 
(cbar)32 
(char )16 
Cchar)8 

(char )0 


/* チ x ックマーク */ 

/* 表示、 S 択琀止 •/ 

/* 道択 Shfc 

/* 探（进択禁止 ）•/ 

/* センタリングづ 
/* 太字*/ 

/»改 U せずに粧統する*/ 

/•終了 （te 後の 9f 索である印 ） */ 
/* 何も指定しない埸公*/ 


9.10 コントロールマネージャの構造体 


コント〇_ルマネージャの供®体は、次のように宜 H されています。 




unsigned 


CONTROL ; 





*P 

yp 


* 8 ; 

y»； 

*n«g ； 


/* コントロールチンブレー) 1 */ 

/* コント o— ル番号*/ 

/• MENU,head と同様の,'®味 • */ 

/* 本質的には AREA であるが ，•/ 
/• スタティックに初期化するのが*/ 
/* 通常の他い方なので，シンブル*/ 
/* に*けるようにわけてある. •/ 
/* 文字列コント〇—ルメッセージ*/ 


9.10.1 標準コント a —ル番号の定数 

棵承コン!•ロール*.号は、次のように定義されています。 


#de£me NULL.CHTL 
•define BUTTON.CNTL 
#define MARK.CKTL 
((define CNTL_CNTL 
#define HBAR.CNTL 
#define VBAR.CNTL 
#defin« CICON.CNTL 
#define IC0N_CNTL 


/* NULL •/ 

/* チ x ックマーク */ 

/* コントロールポタン*/ 
/* 検スクロールパー*/ 
/* 抵スクロール八一*/ 
/* 色付きアイコン*/ 

/* アイコン*/ 
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ffdeline FRAME.CNTL 
«dalins LME—CNTL 
ddefine RQUND_CKTL 
*d«fine ERASE.CNTL 
•define STRING.CNTL 
define TEXT.CNTL 


線*/ 

角の九い四角*/ 
i 色で衆りつぶす*/ 


(define HARK.STD 
ffdefme CNTI..STD 
#define HBAR.STD 
*defioe VBAR.STD 
8d«flna ICON.STD 
#defme FRAME.STD 
#define LXNE.STD 
«define ROUND.STD 
tdefin* STRIHG.STD 


/* スク〇 _ ルバーテンプレート*/ 
/* 攻 fil の位 3S (0 origin) •/ 

/* 全体の fi 数 （1origin) */ 

/* 1ページの行数 （1origin) •/ 


typedel struct .cicon イ 
COLOR on; 
COLOR off; 
TIMY *pat； 

} CICON; 


/* 2 色アイ 3 ンテンプレー 
/* on ド！（卜の色*/ 

/* 〇«ドットの色 •/ 

/* ビツ I •バターン *〆 


9.10.2 コントロールのパート番号の定数 

3ントロールのノ*ート番号は、次のように定義されています。 

*define ALL (cbar)0 /* 全体を示す*/ 

Sdsflne PAGEL 1 /* HBAR.CNTL 左べージ 

#dsfine PAGER 2 /* 右ぺージ 

((define MOVEH 128 /* レバ— 

#defxne PAGEU 3 /* VBAR.CNTL 前ぺージ 

#define PAGED 4 /* 次ページ 

((define KOVEV 129 /* レバ— 


_nsg { /* コノトロールメヴセージへのポインタ • 

11 /* これらは CONTROL.msg に入る，•/ 

*ip； /* すべてのポインタの union だが、 */ 

u; /* C0MTR0I ■にこれを直接入れると*/ 

*up! /* スタティックな初期化ができな*/ 






p;;l-.tp ; r;bar; 1 stllal | 



charchar ik TINY r ARE ABAR™p PEN r TILE c T r° «SG ;w TIKy intillt 画 iiCNTL 


■ジへのキャスト用マクロ 

;卜用マクロは，次のように定典されています。 










^define OPEN.CD 10 

#define CLOSE.CD 11 


9.11 プリンタドライバの構造体 


プリンタドライハ•の梆&体は、次のように as されています。 


•buff; 

id; 

line; 

pid; 
width; 
hlgbt; 

opt; 

copy; 

■sg[32], 


〆* プリントテンプレート*/ 

/* プリントパ，/フ r へのボインタ */ 

〆•プリンタ名*/ 

〆*プリンタ ID */ 

/* 1インチのドット数*/ 

/* 印字1行のドット致*/ 

/* ぺーパーの名前 （A4、A5 など）*/ 
/* ぺーパー ID */ 

/• 1ベージの横ドット数*/ 

/* 1ページの雄ドット数*/ 

〆*1ページの桁数*/ 

/* 1ぺージの行数*/ 

/»拟.横.トラクタ.々ットシート*/ 
/* 明始ページ*/ 

/* 終了ページ*/ 

〆*印刷枚 a */ 

/* メッセージ*/ 


9.11.1 プリンタドライパの播能コード 

プリンタドライパの檐能コードは、次のように定莪されています。 


tdefina PD.INIT 0 
•define PD.OPEN 1 
参 define PD..aOSE 2 
tdefins PD.PRIHT 3 
#d«fine PD.MENU 4 
#define PD.START 5 
Vdsfios PD.PAGE 6 


9.12 その他の構造体 


/* プリンタドライパの初期化*/ 

/* プリンタの印刷明始 as */ 

/* プリンタの印 w 終丫宵■言*/ 

/* 印刷の劣行*/ 

/* 用紙の;»定 */ 

/* 明始 • 終了べージ、印剿枚数の a 定 •/ 
/* 印刷明始メッセージの*示*/ 


その他の稱造体は次のように宣其されています。 


9.12.1 オーパーレイで使用す5構造体 


オーパーレイで使用する構造体は、次のように宜 t されています。 



9.12その他の構 a 体 
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typedef struct .module { /* オーバーレイなどで使用する*/ 

> MODULE; 

9.12.2 モジュール名の宜言 

モジュール名は次のように定義されています。 

#define _public(IO static char 

static MODULE 

#deflne .extern(N) static char 

static MODULE 


__/**/!»[]• •«*4>ub-»*:N"; * 
«H = (MODULE 

/•*/!«[]■ ¥ 
•N ■ (MODULE *)—^/**/9 


9.12.3 日付を表す構造体 

日付を表す*®体は、次のように宜 S されています。 


/» 1980-2079 •/ 

/* 1~12 •/ 

/* 1-31 •/ 

/* 0-HEK. …6•土曜 •/ 


9.12.4 時間を表す構造体 


時 M を表す楙造体は、次のように宣 g されています。 


minute； 


/* 

/* 

/* 

/* 




0-59 */ 
システム予約 


•/ 


9.12.5 MSX-DOS の DPB を表す構造体 


MSX-DOS の DPB を*す構造体は、次のよう K 宣 S されています。 







dintask; 


/* MSX-DOS の DPB •/ 
/* Media ID */ 







i5 章 

MSXView 標準データ 


この章で<1、 MSXView の樣準データについて说明します。 

10.1 MSXView 標準データとは 


MSXView では、あるアプリケーションで作成したデータを、他のアブリケーシ3ンでも 
利用でき4ように、«準データフ T イルのフォーマットが嫌定されています。したがって、 
標準データの登» • 組込の機能をサボートする MSXView アブリケー3ンの蘭では、デー 
夕を自由にや0とりすることができます。 

樣準データファイルはヘッダ部、プライベートデータ部、スタンダードデ_夕部の3つの 
部分から構成されています • 

ヘッダ部は、その檁準データを作成したアブリケージ b ンの ID t プライペートデータ部 
の ft? を記級します。 

プライベートデータ部は，その樣準データを作成したデブリケーシ，ンが自由に使うこと 
ができます。これによって、同--アブリケーシ》ンが作成した樣準データは宪全に元の状® 
のまま再利用することができます， 

スタンダードデータ部は、 MSXView で一般的に使用される描®ファンクシ■ンのシーケ 
ンスとして、データを記録します。そのため、アプリケーションごとに使用するスクリーン 
モードが速っていたり、 ViewDRAW t ViewPAINT のようにデータの表現形式が輿なって 
いても、元のイメージをできるかぎ〇忠*に再現するこ fc ができます • 

樣準データを解釈して実 (5 の描两を行うの It アプリケーションの K 任です • データを組み 
込もうとしたアプリケーシ s ンが、«準データのすべてを取り扱えないときは、元のイメー 
ジを再現することができない場合もあ0ます，例えば、 ViewCALC で作成した円グラフを 
ViewDRAW に組み込もうとした 1 5、 ViewDRAW には円®を取 1 )极う梭能がないために 
闪グラフを表示することはできません。 


10.2 標準データファイルのフォーマット 



10.3 橡!|!■データ： i マンI••の定義 
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10.3 標準デ ータコマ ンドの 定義 

圪準データ屮で描画ファンクンョンを表す3マント•は • aysdata.h で以下のように定典さ 
れてぃます。 

#define STD_SIZE CTINY)0 /• 描画領域の报定 V 

#define STD.SCTPEK (TINY)1 /* ペンの設定 <7 

(tdefine STD.HOVEPEN CTIHY)2 /» ペンの移®)*/ 

#define STO.PSET (TINY)3 /* 点の描阀 */ 

Mefine STD.LINE (TIHY)4 /• 液探の描画*/ 

•define STD.FRAME (TIMY)S /• 四 の描画*/ 

tfdefine STD.BOX (TIMY)6 /* 中を塗りつぶした四角形の描闽 */ 

(tdefine STD.ROUND (TINY)7 /* 角の丸い四角形の描画*/ 

tdefine STD.nLLROUKD (TINY)8 /* 中を塗!)つぶした■角形の描闽 */ 

Mafino STD.OVAL (TDJY)9 /• 円の描® •/ 

#define STD_FILLOV*L (TINY)IO /* 中を镥リつふ•した円の描画*/ 

•define STD.ARC (TIKY)lt /* R® の描 S */ 

•define STD.PAI (TIKY)12 /• 垣 S の描画 •/ 

»dafine STD.FILLPAI (TIKY)13 /* 中を*りつぶした ffl® の描画*/ 

((define STD.POLYCOK (TIHY)14 /* 多角形の描画*/ 

•define STD_nLLP0LYG0N (TINY)IS /* «|> を绝〇つぶした多角形の描画*/ 

tdefine STD.DICON (TINY)16 /* アイコンバターンの描画 V 

*dsfina STD.UMTEBIT (TIMY)17 /* カラーデータの描画*/ 

•define STD.SETFONT (TIHYH8 /« フォントの指定*/ 

Adeline STDJFONT CTINY)19 /» 1文字表示 （1 バイト文字 ） */ 

*defina STD.DIUNJI (TI»Y)20 /* 1文字表示（ンフト JIS) */ 

«d«fine STD.DSTR (TMY)21 /* 文字列の表示*/ 

#d«fine STD.TEXT (TIKY)22 /* TEXT 構逢体 •/ 

*d«fine STD-ARROW (TIHY)23 /* 矢印の描画 •/ 

•define STD.DPATTERN (TINY)24 /» ビッ I•マップパターンの描画 •/ 

•define STD.COLICON (TIKY)2S /•办ラ-アイ；！ンバタ—ンの描画*〆 



10.4 標準データのコマンド 

ここでは、樣準データ内に記録するコマンドについて説明します。 


10.4.1 表記法 

標準データのフォーマットは、次のように表記します。 


コマン ドの機能を示します。 



描画領域の指定 

[コマンド] STD.SIZE 
[_ 引 ft . int xa 
[ » 3 i 


ペンの設定 


[ 01 & I PEN pen 

丨 解 ％ | 

厂参照1 


ペンの移動 



点の描画 


STD.PSET 

匚引 ft 」 なし 

[ W 说 I 祝在のペンの位 S に点を表示します。 

[ # AH ] .pset() (グラフパッハ 


直線の描画 

I コマンド] STD.LINE 


「引 ft 1 int x 班ガ向の位 iS 
int y 横方向の位 K 

[W in I 現在のペンの位 K から x « y で推定した位 K まで at 梅を袖 rt します， 

[参照 I Jinc() (グラフパック> 


四角形の描画 



中を塗りつぶした四角形の描画 



zn 

STD.BOX 

厂づ| ft 1 

int x 抵方向の (tiS 



int y 横方向の位薄 

区 

_ 视1 

現在のペンの位 M とX、 y を対角線とする，中を塗りつぶした四角形を 



描1两します。 

区 

.明] 

-box() (グラフノ<ック） 

角の丸い四角形の描画 


VV ] 

STD.ROUND 

nr 


int x 縦方向の位 E 



iat y 椹方向の位! S 



現在のペンの位湃と x, y を対角線とする、角の丸い Wft 形を描画し 



ます。 

S ； 

•明] 

jound() (グラフパック） 

中を塗りつぶした角の丸い四角形の描画 



円の描画 

「コマンド』 STD.OVAL 


厂引&1 


int x 縦方向の位茜 
int y ffi 方向の位 S 


[解说] 現在のペンの位 S とX， y を対角探とする四角形に内接する円を描画し 

ます， 

[ »照」 - owal() (グラフパッハ 


中を塗りつぶした円の描画 



円弧の描画 


Iコマント.] STD_ARC 


LiiS 


TIMY startangle 
TINY endangle 


«方向の位 K 
横方向の t>y.s 
期始角* 
終了角度 


|解；) t | startangle で指定された角度から endangle で指定された角度までの円 

孤を時；: tfej りに描両します。0形は現在のペンの位 S と、 x、y で报定した 
位$を対角線とする四角形に内裱する H の一部となります • 

[参照コ -arc() (グラフ，《ック> 


扇型の描画 



中を塗1つぶした扇型の描画 


STD.FILLPAI 


r 91 « I 


TINY startangle 
TINY endangle 


繼方向の位费 
m 方向の位 a 
開始角度 
終了角度 


[解说 I startangle で报定された角度から endangle で播定された角度までの、 
中を塗りつぶした梅 S を時31'囡0に描两します。因形は現在のペンの位!5 
と、 x、 ytl 旨定した位 S を対角線とする四角形に内接する円の一部となり 
ます. 

f ^ .明 ] -fillpaiO (グラフパック） 


多角形の描画 
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中を塗りつぶした多角形の描画 

[a マン！ ■* j STD FILLPOLYGON 


[ *(|数 j TINY mm 多角杉の頂 a 5 の R 

POS post] 項点座榡の配列（可変长> 

[W »1 項.存座様の K 列にしたがって. numffl の明点を持つ，中を塗りつぶし 

た多角形を描函します， 


[ # .IS ] -BllpolygonO (グラフバッハ 


ビットマップデータの 描画 

[コマンド] STD.DICON 


[引数 I char patO ビットマップデータ （"J •変长> 

[解 VL ] pat|】 で»定されるビットマップデータを描画します•データは1ドッ 
卜が1ビットで*されます， 

[多照| -diconO (グラフパック） 


カラーコー ドの描画 

I 3マンド] STD.WRITEBIT 


引数] AREA area 描1内エリア 

COLOR color 〇 々ラー: J- ドの K 利（可*羡> 

W 说 | color で指定される;>ラーコードの配列を area で播定した傾域に描画し 

ます。1ドットか1バイトで表されます， 

9 照 1 writebilO (グラフパ.メク> 
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フォントの設定 


[= ZEJ ] 

STOSETFONT 

1 引！ ) 

FONT font FONT 携造体 

丨解说 | 

文字表示用の7ォントを說定します， 

[参照 | 

ド ONT 搆造体（フォントバック） 

1文字表示 （1 バイト文字） 

丨コマンド1 

STD.DFONT 

Mi a | 

char c 表示する文字 

I 解说 I 

1バイト：! _ドで*される、荚号文字を表示します《 

丨参照| 

-dfont() (フォントパック} 

1文字表示（シフト JIS ) 


I コマンド '] STDJJKANJI 


〔 51 ft I WORD sjis シフト JIS 文字コード 
[ » » ] sjis によって指定した文字を*示します， 

[參照 I 


dka »( ji () (フォントパック） 



文字列の表示 


しコマン上 J STD DSTR 

数= char surf] 文字列（可変 fi> 

I » 说1 文字列を*示します。文字列の最後に <i0x00 が必要です， 

[参照] -< lstr(}( フォントパック） 


TEXT の設定と表示 


STD.TEXT 

TEXT text TEXT 構造体 
text で推定したテキストの K 定と表示を行います- 
TEXT* 造体（テキストマネージャ） 


矢印の設定と表示 
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7 オントの設定にしたがったパターンの表示 

[コマンド！ STDJJPATTERN 


引数丨 char patU パターン（可変长> 


現在のフォントの R 定にしたがつた錄りつけをして、 pat [丨で指定した 
パターンを我ホします。パターンのサイズは現*:のフォントと同一でなけ 
ればなりません， 


#照 ]- dpattern() (フォント'ぐ y ク） 


カラーパターンの 表示 

[コマンド | STD.COLICON 


QL 


幻 




Isl 


WORD xsize 
WORD ysize 
COLOR oncolor 
COLOR offcolor 
char pat[] 


横方向のサイズ 
班方向のサイズ 
オンドッI•の色 
才7ドットの fe 
パターン（可* ft) 


pat" で指定されるパタ—ンを xsize，ysize の大きさと， oncolor.offcolor 
の色で表示します。 


I # 照] -c*lic*n() (グラ7バック> 



11 章 

デイス プレイ マネージャ 


この章では、ディスプレイマネージャの«成や各フ T ンクシ■ンについて说明します。 

11.1 ディスプレイマネージャとは 

MSXView での画面表示はすべて、 VDP (V9958) のビットマップグラフィックスモード 
を使用し fc オーバーラップウィンドウ（互いに*なりあうことのできるウィンドウ）環境で 
行われます。ディスプレイマネージャは、この才ーパーラップウィンドウ環境を統一的に管 
理する®*なマネージャで、 VDP の4種级すべてのビットマッブグラ7■(ツクスモードを使 
用することができます。 

MSXView では、ウィンドウ®境を*持するために、«面への表示は必ずディスブレイマ 
ネージャをとおして行います。一般的なオーバーラップウィンドウ®堆（例えば、 MacOS や 
MS-Wndows など）では、他のウィンドウによって B されたウィント•ウを表に出すために 
は、アブリケーシ》ンがウィンドウを再描两しなければなりません，しかし、 MSXView の 
ウィンドウ環境では、ウィンドウの*なりにより失われる«分は、ディスプレイマネージャ 
マネージャが自|»妁に待遵_0權するので、アブリケーシ^ン例で，再描画する必要はあ0 
ません。ただし、 * ねられるウィンドウの総面格は、裏 VRAM1 画面分までに制限されま 
す。このウィンドウを、 「FLOAT ウィン！••ウ J と呼びます • 

FLOAT ウィンドウは、画面上に明ける面 W に限りがあるため、 MSXView には、 ^FIX ウィ 
ンドウ j という才ーパーラッブができないウィンドウもあります。各アブリケーシ 3 ンの描® 
領域、作!!領域など大きな面褙を使用する部分をウィンドウ管 * するに li、FIX ウィンドウ 
が便利です。 FIX ウィンドウは*なりあうことができませんが、 FIX ウィンドウと FLOAT 
ウインドウとが®+なり A うことはできます。 


11.2 ディスプレイマネージャの使い方 

画商に何かを描くとき U、 以下の手顚で理を*めます。 


1. 描幽するウインドウをカレントウィンドウにする。 

ます、描画するウイン！••ウをアクティブにします。画面上で同時にアクティブになるこ 
とのできるウィンドウは1つだけて、 MSXView ではこれを;»レントウィンドウと呼び 
ます。々レントウィンドウを変更するには、 j*win(>. _pushwin() などのファンクシ s 
ン（後述）を使います。 

2. 描画するエリアをズームする。 

描画するためには，描画するエリアを指定しなければなりません*これを、 MSXView 
ではズームと呼びます，ズームすることにより、以下のような热理が行われます • 

• ズームされる描画領域の上に别のウインドウがあるときは、そのウインドウの® 
なっている部分だけが一時的に取り除かれ描画領域が表面に表示されます。 

• ズームされた描画®域にカーゾルが*なる場合には、カーソルを表示しないよう 
I二 t ます。 

3. グラフノ<ック、7ォント /•« ックなどを使用して描画する。 

図形（文宇）を描く場合はすべて、ズームした描画領域に対して行われます。 MSXView 
では嫌々な H 形や文字を描くために、グラフパックおよびフォント，ぐ y クが用意され 
ています。 

4. エント•ズームして、描画環境を回银する。 

描画が終わったらできる限りすみやかにズーム状 S を W いて下さい • ズーム状想では、 
描阏領域に*なったカーソルが表示されないなどの間姐があるので、描画が終わった 
らすみやかに •endzoom() フ r ンク•〆 s ンを呼んで、描画環埃を回议して下さい， 

5. ウィンドウ IB 境を元に戾す， 

描画のために*レントウインドウを変史したときには、これを元に戻すようにつとめ 
て下さい。ウインドウ環境を元に庚さないと、後の描画)4理に M 埋が起こることがあ 
ります • 


画面に何か図形を描くときは^ウインドウ上の描画領域をズームし，グラフパック、フォ 
ント/<ックを使って薄き込んで行きます。ズーム中は描画領域内では，力_ソル U 自動的に 
消えます- t き込みが柱了したら、必ずエンドズームして，描画現境を元に馬して下さい《 
ウインドウ間を図形が横切るような特別の場合（ウインドウの移勒など〉は、ダイレクト 
にルートボート•に眘き込むこともできますが、ラパーバンド （11.3.1 r ルートボード j 参照） 
を使うなどして、画面を壊さないように注意して下さい。 

11.3 ディスプレイマネージャの構成 


デイスブレイマネージャは、以下のような概念で画面を管理します。 



11.3 デイスプレイマネージャの構成 
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11.3.1 ル•ボード 

ルートボードとは》ウィンドウが配®5れる画面そのもので.画面と同匕サイズの待珠な 
ウィンドウです，画面上で勳くことのない梢報などを表示します，ウィンドウを移 W すると 
きは、況咖⑷を使って，ルートボ ーP 上にラバ—バンドで梓を表示することができます • 
ルートポードは、色とタイルパターンを待つことができます， MSXView では、ルートポー 
ドも1っのウィンドウとして扱うようになっており、ウィンドウハンドル1が削り当てられ 
ています。 

11.3.2 ウインドウ 

ウィンドウには r FlX ウィンドウ j と r FLOAT ウィンドウ j の2钱類があ >) ます， 「FIX 
ウ■(ンドウ」には、 TLOAT ウィンドウ j にはない制限があります。 

FIX ウィンドウ 

FIX ウィンドウとは、侍避画面エリアを持たないウィンドウのことです • このウィンドウ 
には、画面を保存する領域がないので，クロ*-ズしたときは由 W の情報が i 肖えてしまいまず。 
FIX ウィント•ウどうしを*ねることはできませんが、面®上で1ならない限り、画面一杯ま 
で明くことができます。 

FLOAT ウィンドウ 

FLOAT ウィンドウと遑い、制限 li あ 1 )ません，自由に*ね合うことができ、移勦させる 
こともできます，ただし、明ける FLOAT ウィンドウの fi« は、合針で面面1枚分までです。 

表 3.4 FLOAT ウィンドウの«類 


名前 形 

TWIN 何もなし（待別な用途のための透明なウインドウ） 

CWIN 枠なし 

FWIN 梓つ S 

RWIN 角の丸い枠つき 

IWIN インデックス（上端の角が丸い枠）つき 
SWIN 肜付き（右下に彩がつく） 

BWIN 二*枠つき 


口 

RWIN 1W1N SWIN BWIN 

図32各ウインドウの形状 



FWIN 
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通常の描®領域には FWW を，ボ》ブアップメニューなど注 B させたい a 分には、 SWIN 
または BWIN を使うの一*的です。 

それぞれのウインドウがどのように定袭されているかは、 9.3.1 •■ウインドウスタイルの定 
ftj を参照して F さい， 

11.3.3 ズームの 概念 


ディスプレイマネージャにおけるズームとは、ディスプレイマネージャに描画を K3 する 
ことでズームされた領域は、たとえ他のウィ〆ドウで S い S されていても、一時的に表 
に出されます。このため、ウィンドウの«先度などを変 K するときに，アブリケーシヨンが 
ウィン！••ウを寄き直すなどの手明；!!*かかりません。また问時に，マウスカ--ソルがズームエ 
リアに.承なる場合には、的にマウスカーソルも消去されて，描《の! fl!» をしないように 
します， MSXView 環境では、マウス々ーソル t ウィント•ウ k の S まざまな表示も問じビッ 
トマップ VRAM に格納されるので、ズームを行なわずに ft* をアクセスすると、いろいろ 
な»害が生じてしまいます。 

ズームすると，オーパーラップウィント•ウ環境が一時的に破®されます。したがって、ズー 
ムは必要*小限の領域を、必要 ft 小限の時阳だけ行なう（描 _i が終了したら直ちに _endzoom() 
を呼ぶ-)ようにして下さい。そうしないと、マウス々ーソルが m えるなどの r»i 姐が ft 午します。 


11.3.4 ディスプレイマネージャで 使用する データ 構造 

デイスブレイマネージャではウインドウを W 理するために次のような«造体を使用してい 
ます， 




HANDLE 

HANDLE 

HANDLE 

HANDLE 


_win < 
block; 


defpen； 

deffont; 

curpeni 


/* ピットプロックハンドル*/ 

/* ウインドウの状®*/ 

/* ウインドウデフオルトペン*/ 
/* ウインドウデフオルトフオン！ • 
/* ウインドウカレントペン*/ 

/* ウインドウカレント7オント */ 


statu* の: f 味は次のようになっています。 
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3 


FIX 

Clo&od 







11.3.5 ペンハンドルとフォントハンドル 

MSXView では，描两のための S3 境をペン (PEN) と呼び、文字の*性を表現するための 
さまざまな tff#S の集まりをフォントテンブレート (F»NT) と呼びます。デイスブレイマネー 
ンャは、 PEN や FOMT を、ハンドルを通して扱うための楱能を持っています，これらの情 
«をヘンドル©®ことによ!?、以下のようなメリットがあリます。 

• PEN、FONT など li サイズの大 S な構造体なので、ハンドルで 1F 理するとメモリ効串 
が良い。 

• 裡 ft のモジュールで共通の PEN、FONT を冊単に共用することができる。 

• 輿なるウインドウでは、描幽に使用するペンやフォントの5!境が大きく興なることが 
多いが、 PEN や FONT をウインドウの〇性として持たせておくことで、ウインドウ 
を切り換えるだけで、 PEN や FONT も fllft 的に切 1 )換えられる。 

PEN や FONT の詳細については、グラフパックおよび7オントメぐ y クを#.明して下さい. 

11.3.6 デフオルトとカレント 

ベンハンドルとフォントハンドルに W、 それぞれ々レントペン、カレントフォントが1つ 
だけ/ ft します。同時に棋数のペンやフォントが々レントとなることはありません。グラフ 
ノぐ y クは々レントペンに基づいて描画し、フォントパックは々レントフォントに基づいて、 
文字を表ボします。 

カレントペンを*®するには、 -chpen()、-pushpe.n() などのフアンクシヨンを使用します。 
また冷レントフォントを変 C するには^ xhfont() N -pushfont() などのフアンクシ3ンを使 
用します， 



スグ ¥ —ンモ _ ドの议定 
ペンハンドルの初期化 

ペンの作成 

ペンの削松 

カレントペンの S5E 

カレントペンの®得 

保存をともなう*レントペンの变史 

々レントペンの愎埽 

ペン衍報の®得 

ペンの E 新 

デフォルトペンの®得 

フすントハント•ルの初期化 

フォントの作成 

フォントの削除 

カレントフォントの变思 

カレントフォントの棰得 

保存をともなうカレントフォントの変史 

フォントの後« 

フォント情報の裡得 
フォントの更斩 
デ7ォルトフォントの港得 
ルートボードのクリア 
ウインドウマネージャの初期化 
ウインドウの作成 
ウインドウのオーブン 
ウインドウのクローズ 
ウィンドウの削除 



S 味 


.cleanvinlj 

.frontwin() 

wwin() 

Jindwin() 

ch»^n() 

pushwii>0 

-gw>l() 

ilog() 


ウィン H ■ウの夕”ア 

ウィンドウ tff 報の®得 

ウィンドウの变 K 

ウィンドウを最前而に移動 

ウィンドウを Ai 後面に移® J 

ウィンドウの位 K の移勒 

ウィンドウサイズの変疋 

ウインドウハンドルの梅 S 

办レントウィンドウの変 E 

カレントウ•（ンドウの®得 

保存をともなう勿レントウィンドウの変 E 

#レントウ■(ンドウの at« 

グロ ーパル®標から〇—カル？ Ktt への変換 
D — カル***からグ D — パル®«への変換 
ボップアップウィンドウ位 a の 
エリアのズーム 
ウインドウのズーム 

x_ ムの終 r 
スクリーンサイズの货 w 
スクリーンモ_ドの*得 




11.5 フアンクシヨンの説明 

以下では、デイスブレイマネージャの各フ7•ンクシ3ンについて说明します。 


11.5.1 表記法 

フアンクン3ンの说明では、次のように表3己します. 


ファンクションの機能を 示します 

r 機能# y -丨备フアンクシ3ンに別り当てられている*冷です， 


LZ 




I戻り値I 


备7 7■ンクシヨンを使用するときの并式を示します。 


-フアンクシヨンの庚リ»のV 


-フアンクシ■ン名 


，ドウハンドル 
1 — 61ft の*味 

-引»の受け*しに使われる CPU レジスタ 

<7■センプラプログラミング時に使用） 
- 9ia 名 

- 4IR の B 


そのファンクシ3ンの的作の* S*. どのような tt が返されるかを 
示します， 


_«•)« の®味 
一戻〇饊 

—戾リ值の引き®しに使われる CPU レジスタ 
(アセンブ9ブ〇グラム時に使用） 


[解说 j そのフ r ンクシ3ンがどのような動作をするかを示します。 



ウィンドウマネージャの初期化 



3¢ U 章デイスブレイマネージャ 




ウィンド ウの作成 __ 

01能#号 j 72 

I 并-式」 HANDLE createvin(area, style , win, pen, font) 

AREA »area [HL] ウィンドウの領 M 
TI»y style [E] ウィンドウの形状 

(FIX i たは FLO AT の指定） 

HANDLE win [C] ウイ〆ドウハンドル 

HANDLE pen [A，] デフォルトとなるペンのハンドル 

HANDLE font [E*] デフォルトとなるフォントのハンドル 

[K 'J {£ I [A] ウィンドウ/、ンドル 

作成できなかった場合 EBBQfl 



新しいウィン！^ウを作成します， 

area には、 AREA «造体 （9.2 •■基本的な搆造体 j 参照）へのポインタ 
を报定します， 

.style には、 FIX ウインドウや FLOAT ウインドウのスタイルを指定しま 
す。ウインドウスタイルについては、 9.3.1 1 ■ウインドウスタイルの定数 J 
および 11.3.2 •■ウインドウスタイル j を麥照して下さい。 

win が0の場合は新しいハンドルを加り付け、それ以外の場合はその値 
をハンドルとして MfJ 付けます。このとき、複数のウインドウが1つのハ 

ンドルを共有することはできないので、アプリケーション内でウインドウ 
を固定的に制り付けるなどの特殊な場合を除き、通常 Bwin に0をセット 
してコールして下さい。同じ ffi を持ったウィンドウハンドルが存在すると 
きは、すでに存在しているウィンドウが削除され、新しく作られたものに 
引き換えられます，ウインドウハンドル1は、ルートボードとして剌リ当 
てられているため、通常のウインドウとしては使用できません。 


pen と font には、そのウインドウのデフォルトとなるベンとフォント 
を fi 定します • このとき、 pen に SYSPEN、font には SYSFONT {共に値 
は 1) を指定すると，システムの棵準ペンと標準フォントが使用されます。 
NEW (值は 0) を指定した場合には、新しいハンドルか刻り当てられ、 ft 
動的に楳準ペン、標準フォントの内容がコビ•■されます。この場合、割り 
付けられたハンドルを知るには、後述の办1«1咖《1〇、名 etdeffontQ を使 
W します， 



11.5 フアンクシ 3 ンの Jft 明 
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ウインドウのオープン 



I * 式"! STATUS _openBin(vin, x, y) 

HANDLE wiD [A] ウインドウハンドル 
WORD x [BC] 横方向のグローパル位芮 
WORD y [DE] 縦方向のグ〇-パル位逋 

[K 0 ffi I [A] OK 才ーブン成功 

ERROR オーブン失敗 

「解脱 win で指定したウィンドウを、X、 y を左上とする位 R に才ープンしま 

す • 、两方に OxfffT を指定すると、作成されたと#の位 S (デフすルト 
の位逋> にオープン3れます ■ 


ウインドウのクローズ 



| 古式， STATUS closeuln(uin) 

HANDLE win [A] ウイン！••ウハンドル 


[戻り® I [A] OK クローズ成功 

ERROR ク〇_ズ失敗 

「解说| win で指定したウインドウをク〇—ズします 0 阕面からは消去されま 

すが、 S 画面にある保存供城はそのままなので、もう一$、 -openwin() を 
使用してオープンすれば前の状®で S 面上に表示されます。本当にその 
ウィンドウが不必要になったときは、 JeletewinO を実行して下さい•た 
だし、 FIX ウィンドウの場合は保存两域がないので、う一度オーブンす 
るとウィン！••ウクリアされた状路になってしまいます。 
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ウイ ンドウの削除 _ 

[嫌《6 f V」 75 

I js -jf STATUS .deletevinlwin) 

し上 - HANDLE win Ul ウインドウハンドル 

屏り値 _j [A] OK 削除成功 

ERROR fl 龄失敗 

PS — Sn wm て•相; £ したウィンドウを削除します。才-ブンされているウィンド 

' - — ゥが携定されると、ク〇-ズしてから削》されます•また. SSSlti に確保 

されてぃ4保存領域も間時に解放されます • 


ウィンドウのクリア___ 

p 能#号] 76 

I 5 式 | STATUS .clearvin(vin) 

- ' HANDLE win [A] ウィンドウハンドル 

| 戻り値 | [A] OK クリア成功 

ERROR クリア失敗 

! W id 1 W m て滞定したウィンドゥをクリアします。ウィンドウ*噺しく作成さ 

れたとさと酙じ表示になりまず。 


ウィンドウ情 報の獲得 

[嫌能 *_£) 77 


「 * 式'! STATUS ^etwininfo(vin, info) 

1 - HANDLE uin IA] ウインドウハンドル 

WIN •info 【DE] WIN* 适体へのホインタ 


j 戻り値| [A] 0K 播得成功 

ERROR 推得失敗 


win で播定したウィンドウの状怒を info に返します。 



ウインドウの変更 

[je 能悉■号： 78 

式—1 


STATUS .BetwininfovIi info) 

HANDLE win [A] ウインドウハン！•■ル 

WIN *imfo COE] WIN W 造体へのボインタ 


win で指定したウィンドウの状態を、 info に K 定した内容ししたがっ 
て変史します，この 7 t ■ンクシ a ンでは、アブ 1 /ケーシ s ンでは使用しま 
せん。 


ウィンドウを最前面に移動 



ウィンドウを最後面に移動 

@能# V 丨 8* 

I * 式 I 
[K リ值 I 


ウィンドウの位置の移動 



ウインドウサイズの変更 


庚リ fA 


82 

HANDLE win U] ウインドウハンドル 

WORD xsize [BC] 横方 l;4 のサイズ 

WORD ysize [DE] 縦方向のサイズ 

[A] OK 変史成功 

ERROR 変更失敗 


« 说 win で播定したウインドウを， »ize. ymze で梅定したサイズに変 K し 

ます，ウィンドウを嫌' J、 したは方曲が办ッ（•され、 te 大した ts 
は右下方向に広が9ます， 


ウインドウ ハン ドルの獲得 



カレントウインドウの変更 


拽能悉•号1 

84 


f 备式 1 

STATUS 

.chwin(win) 


HANDLE 

Bin [A] ウインドウハンドル 

1 K り®’ 

[A] OK 

変更成功 


ERROR 変圯失敗 

| W 說: 

カレントウインドウを* in で播定したウインドウに変®します。 _gtol() 


joomO などをはじめ、描画に関するすべての処琿は、カレントウインド 


ウに対して行われます- 

カレントウインドウの獲得 

後能*号| 

85 


1 件 式丨 

HANDLE 

.<nirreDtBin(void) 

「戻 1 ) (B 1 

[A] /n. 

■ントウインドクの/、ンドル 

丨 K 说| 

カレン1 

トウインドウのハンドルを返します。 

保存をともなうカレントウインドウの変更 



カレントウインドウの復帰 



I fr •式 | STATUS .popuin(void) 

[戻り« I [A] OK 復《成功 
ERROR 彳 8W 失敗 

[W % I スタックに保存したウインドウハンドルを取り出し，カレントウ<ンド 

ウとします。 .pushwinO と対にして«います， 


グローバル座標から口一カル座標への変換 


[機能*ポ 88 

I 齐武丨 POS «-gtol(global, local) 

POS (global [HL] グローパル座榇 
POS 'local [DE] ロー々ル座 


[戾り tt I [HL] local へのポインタ 

[ 解说 I global で报定したグローハ•ル®橾の1点を、カレントウインドの O- 力 

ル座標へ変換して、 local に返します • ウインドウ内でのマウスカーソルの 
位3などを M ベるために使います， 


ローカル 座標から グローバル 座標への変換 



エリアのズーム 


[st m 9i 

— AREA *area [HL] ズ-ムするエリア 

[_ 庚り値’ なし 

[解説] 々レントウインドウの捎定された®域を.描画で S る状態にします。指 

定した領域が、他のウインドウの下に®されているときは、1番上に出し 
ます。その領域では、マウス々ーソルは表示されません • 

ウィンドウのズーム 


I機能#号| 92 


嘗式 void -zoonuin(void) 


[« ') ® ; なし 


「解说] カレントウインドウ全 f 本を、描画できる状®にします•ウインドウを HR 

いた直後の描阃などに便利ですが、マウスカーソルがウインドウに少しで 
も重なっていると、マウスカーソルが i 肖えてしまうので、ウインドウを»1 
いた直後の初期化のための描画など、大きなエリアを軎き換えるときに使 
います。 


ズームの終了 



ポップアップウインドウ位置の設定 


[檐能*好 j 90 


POS *center [HL] 中心座樣 

AREA *area [DE] ポップアップウインドウを表示するエリア 


[si 0 fl] なし 


[w ui : ボップアップウィント•ウを表示する位 s を a 定するための77■ンクシ a 

ンです， center にボップアップの中心座樣， area にウインドウの大きさを 
指定すると、自助的に center を中心とし，阑面に収まるようにボップアッ 
ブウイン！'•ウの位 Z を修£します，このフ7■ンクシ a ンは、メニューマネー 
ジャがポップアップメニューの位 B を決定するときにも使われています， 


ペンハンドルの 初期化 



フォントハンドルの 初期化 


[ 梭能 JI 号 157 

I 甚式 I void . initfonthandle ( void ) 

[戻り値：なし 


[»!«.] フォントハンドルを初期化します • このフ r ンクシ 9 ンは•ンステムが fl 

勒的に突行するので、アブリケージ3ンから呼び出す必要はありません， 


ペンの作成 
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フォントの作成 _ 

|楼能#号| 

58 

r~¥ 式 r 

HANDLE .createfont(info, font) 

FONT *inio [HL] FONT 構造体へのポインタ 

HANDLE font [E] フォントハンドル 

f « >) ml 

[A] 作成された 7 f ントのハンドル 
作成できなかった場合 ERROR 

1 «说 1 

フォントを作成し、そのハンドルを返します • info が0のときは、シス 
テムフォントの毅:定がコビーされます。 font が0のときは、新しいフォン 
|•ハンドルを返します， 

ぺンの削除 

|梭能番号| 

49 


void deletapan(pen) 

HANDLE pen [A] ペンハンドル 

丨戻り値1 

なし 

|解—14」 

pen で指定したペンを削除します。削除するのはアプリケーシ s ンで作 
成;したペンだけにしてドさい， SYSPEN などを削除すると、 MSXView が 
正常に動作しなくなります。 

フォントの削除 

丨拽能番号| 

59 

| Sf 式 | 

STATUS .deletefont(font) 

HANDLE font [A] フォントハンドル 

| 戻 1 ) H 1 

[A] OK 削除成功 

ERROR 削除失敗 

丨 W 说1 

font で播定したフォントを削除します。 
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ペンの変更 

5() 

HANDLE pen [A] 変史するペンのハ〆ドル 
なし 

カレントウィンドウに越する亡レントペンを、 pen で衍:£したペンに変 
9!します。 pen が0のと春は、勿レン！■ウィンドウのデ7ォルトペンが a 
定されます。 

フォントの変更 



HANDLE font [A] 変 K するフォントのハンドル 

なし 

* レントウインI■•ウに Ht るカレントフォントを、 font で报定したフォ 
ントに変 K します。 font が0のときは、 d レントウインI■•ウのデフォルト 
フォントが»定？れます， 

ぺンの獲得 

51 

HANDLE .currentpen<»oid) 

[A] ペンハンドル 

#レントペンのハント•ルを返します • 




11.5 フアンクシ a ンの说明 103 

カレントフォントの獲得 

1檐能#及] 

61 

1 S U 

HANDLE .currentfont(void) 

:ぺ W 

[A] フォントハンドル 

1 W 31 ] 

办レントフォントのハンドルを®します。 

保存をともなうカレントペンの変更 

| 檐能療^ 

52 

1 ar 式 1 

STATUS pushpen(pen) 


HANDLE pen [A] ペンハンドル 

1 埃り桃"] 

[A] OK 変史成功 

ERROR 変] 6 失敗 

丨解说1 

カレン トペンをスタ y クに保存し， pen で指定したペンを々レントとし 
ます。 -poppen(} を使うと、々レントペンをXに J5J すことができます。 pen 
が0のときは、レントウ < ンドウのデフォルトペンが設定されます。 

カレントペンの 復帰 

1 梅能#号 1 

53 

并式 I 

STATUS .poppen(void) 

1 u り値 | 

[A] OK 斑《成功 

ERROR 失敗 

|解说| 

スタ y クに保存したペンハンドルを取り出し、泠レントペンを元に戻し 
ます。 -pnshpenO と対にして使います。 
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保存 をともな う カレ ントフ ォント の変更 

[檐能*号'' 62 

L 寄 _式 STATUS .pushfout(font) 

HANDLE font [d] フォントハ〆ドル 

[厌り tt] [A] OK 変更成功 
ERROR 変更失敗 


々レント7ォン！•をスタックに稱み， font で供定したフォントを々レン 
トフ t ントとします。 font が0のときは、ウインドウのデフオルト7オン 
卜が》定されます • 


フォン トの復帰 

[槺能#号」 63 

[•式] STATUS . popfont ( void ) 

[庚り値] [A] 0K 极 M 成功 
ERROR 愎《失敗 

f 解说I スタックに保存したフォントハンドルを取りだし.カレン！•フォントを 

元に戻します。 -pushfontO と対にして後“ます， 


ペ ン情報の獲得 

[裱能$号] 54 


厂書式1 


PEN *.penadrs(pen) 

HANDLE pen [A] ペンのハンドル 


[戾 0 值 I [HL] PEN 構造体の先頭アドレス 



pen で指定:した PEN 構3体のアドレスを返します， PEN の内容を一部 
変更するときなどに使います。 



フォン ト 情報の獲得 _ 

[核能 S «■] 64 

[® 式] FONT * fontadrs(font) 

HANDLE font [A] フォン！'ハンドル 

[si •) flS I [HL] F0NT«)2i 体の敗•アドレス 

[» 说 I font で指定した F«NT«® 体の 7 ドレスを返します • FONT の内容を 

—部変 K するときなどに使います， 


ペンの更新 


[機能# V! 55 

[方•式1 STATUS reneHpen ( pen ) 

HANDLE pen [ A ] ペンのハンドル 


[U >) ffi] [A] OK S 斯成功 
ERROR £ 新失敗 


[W 说」 -penadrsO などを使って、 PEN の内容を*•きえたと S に、その祈し 
いペンで掐_する前に呼び出します。 


フォントの更新 


JoniadnO などを使って、 FONT の内容を* 5換えたとさに.その新 
しいフォントで文字を出力する«に呼び出します。 -chfont() と《ぼ|31嫌の 
*5： 現を行ないますが、それよりも«速です， 
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f フをル ト ペンの 獲得 

[檐能番号] 56 



HANDLE _getdefpen(void) 

[A] 办レン！•ウインドウのデ7オルトペン 


W 说 1 冷レントウインドウのデフオルトペンを返します。 


デフォルトフォントの獲得 

I 機能番母 j 66 

I 赛式 | HANDLE .getdoffont(void) 

[庚 1 )侦1 [*] フォントハンドル 

f 解说丨 デフォルトフォントのハンドルを返します。 


スクリーンモードの設定 

[棰能35号•丨2 

| 方式 | void .screen(mode) 

TINT mode [A] スクリーンモード番号 （BASIC と同様〉 

[戾9值 I なし 


スクリーンモードを変更します • 报定できるXクリーンモー T! は 5-8 
までと、 10-12 までです。不正なスクリーンモードが指定され办ときは 
何もせず戻ります。 


[ « W ] 



11-5 フアンクシ 3 ンの説明 


スネ_リーンモードの獲得 

[檐能盎号. 388 


厂 g 式1 
{~>/ ： •) a j 

[inn. 


TINY ^etscreennode(void) 

[*) スクリーンモード番号 <BASIC と同樣） 
現在のスタリーンモードを返します。 


スクリーンサイズの獲得 


[機能*号] 374 


| 2 式 | void -screezi3iz«(area) 

- AREA *area [HL] X クリーンサイズが返される 

AREA 構造体へのポインタ 


男り® I なし 


(_ 解说丨 現在のスクリーンサイズを area に返します， 


407 



12 章 

ビットブロック マネー ジャ 


この章では、ピットブロックマネージャの構成や各フ r ンク ys ンについて 1)4 明します， 

12.1 ビットプロックマネージャとは 

ビッI•ブ〇ックマネージャは、ウィンドウ te 現を高速化するために、画面上の矩形傾城を 
効率的に* VRAM に格納するためのマネージャです， オー パーラッブウィンドウの再描画 
処理をアブリケーシ s ンが行なわなくてもよいのは、ビットブ D ックマネージャが、0,され 
る部分を«に1ラインずつスライスし、上から*に* VRAM へ 待避しているからです， 
ビットプロックマネージャは、•■プ 〇，メ ク 」 と•■ロヴト j tv 、 う概念でデータを管理しま 
す，ブ〇ックとは、1つのデ'-夕を表すビットの集ま9で、複数のブロックの集まりをロッ 
卜と呼びます， 

ディスブレイマネージャは MSXView 起動時やスクリーンモ•■ドが! C わるときにビットブ 
〇-/クマ冬ージャを初期化して、 SYSLOT と APLLOT. という〇ットを1つずつ作ります。 
SYSLOT はロット番号1、 APLLOT は〇ット番号2 です. 

ビットブロックマネージャは、ウィンドウ簀薄.の内部 tea ルーチンとしてディスプレイマ 
ネー ジャが使用しますが、アブリケー vs ンでもデータ保存領域として使うこともできます。 
この場合，アブリケーシヨンは APLLOT つまりロット*号2のみが使用可能です。ディス 
ブレイマネージャも APLLOT を使用す名ので、アブリケーシ3ンがデータ領域として使う 
ときは、その分ウィンドウの进•避領域が減ることになリます。 

ディスプレイマネージャやアブリケーシ a ンが、 .ucwblcO を呼んでプロックを作成する 
と、ハンドルが返され、それ以降のブ〇ックに対する谈み®きは、そのハンドルでブロ‘ノク 
を指定して行ないます • ブロックの使用が終了したら、 JrocblcO を呼んでそのプ〇-/クを解 
放しなければなりません。 

なおスクリーンモー（••を変更すると、画面は初期化され、すべてのデータおよびウィンド 
ウは消去？れます • 


第12¢ビッI•プロックマネージ 


ビットプロックマネージャには、以下の77■ンクンヨンがあります。 


表 3.7 ビットプロックマネージャのフ r ンクシ3ンー览 


ビットブ〇ックマ本ージャの W 期化 
«坩〇ットの別り付け 
ロットの解放 
新規ブロックの枨得 
プ〇ックの解放 
プ〇ックへの保存 
プロックからへの S 示 
プロック内と»«の ft «の交換 
プロックサイズの変更 
ブロックへの®像の保存 
ブロックからの两像の取り出し 
プロック上の々ラー 3 —ドの播得 
プロックへの点の*き込み 
ブロックからメモリへの较み込み 
メモ IJ からブロックへの畜き込み 




ファンクシヨンの機能を示します 


[嫌能 s yj 
式I 


[bj •) 値1 


各ファンクシ3ンに割 1 )马てられている#号です • 


ft フアンクシ3ンを使用するときの方式を示します。 


STATUS 

HANDLE 


フ7•ンクシ3ンの以9値の型 



^16 


I—引 ft の®眛 

-418[の受け*しに綾われる CPU 

(アセンブラブ〇グラミン 
-弓 lft« 


9IS の B 


そのフアンクシ s ンの勳作の結*、どのような後が返されるかを 
示します。 



ビットブロックマネージャの初期化 


[tt DS # 9] 118 

し方式〗 STATUS initblc(xsize) 

WORD xsize [HL] スクリーンの槁方向のサイズ 


[戾り値 I [A] 0K 初期化成功 

ERROR 初期化失敗 

[解 Sft I ビットブ D ックマネージャを初期化します•この77•ンクン s ンはシス 

テムが S 助的に実行するので、アプリケーシ3ンから呼び出す必要はあ9 
ません • 


新規ロットの割り付け 
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ロットの解放 

[檐能#号1 120 

「 S 式 I STATUS jfreelot(lot) 

HANDLE lot Ml ロットハンドル 

[戻り® 1 [A] DK 解放成功 

ERROR 解放失敗 

[W 说| lot で析定した D ットを解放します。 


新規ブロックの獲得 

[機能番号I121 


厂 > 式 I 


HANDLE Jiewblc(lot a xsize, ysize) 

HANDLE lot [A] ロットハンドル 

WORD xsize [BC] プ〇ックの横方向のサイズ 

WORD ysize CDE] プロックの板方向のサイズ 


[A] ブロ y クハン！••ル 

〇ットの確保に失敗した場合 ERROR 


[解说 ] xsize. ysize で捎定したサイズの新い、プロックを、 lot で报定した〇ッ 
卜に確保して、そのプ〇ックを参照する，、ンドルを返します。 


ブロックの解放 

檐能礬号丨 122 

, S 式 i STATUS .freeblc(block) 

HANDLE block [A] プ〇ックのハンドル 



ERROR W 放失敗 

block で指定した*号のブロックを解放し、そこを麥照するハンドルを 
破棄します， 


[W 说I 



ブ □ 7クへの画 像の保存 

「逆能番号]127 

[S A I HAKDLE -8 toreblc ( area , lot ) 

AREA -area [ HL ] 画 ®h のエリア 
HANDLE lot [E] ロットハンドル 

[ M り値. [ A ] ブ〇ックハンドル 

保存領域が足りなか'_>た場 ■ 0 


解说 | area で播定した領域と同じサイ•■の新しいブロックを、1〇■て•推定した 

ロットに碎保し、 ar 的内の«像を霸^1て、そのザロ./クを■照するハン 
卜•ルを返します。戾リ供が * のと保存領域#:足りない，とを示して 
いるので.新い、幽慊は保存できません， 


ブロックからの画像の取り出し 



ブロック上の カラーコー ドの獲得 


li 能番号') 



[埃り値 I 

[ » sa ] 


COLOR blcpoint(block, zp, yp) 

HANDLE block [A] プ〇 ックハン！••ル 
WORD xp [ BC ] プ〇 ック内の横 /j •向の座 揉 
WORD yp [ DE ] ブ D ック内の 雄 方向の座榇 

[ A ] カラー3— ド 

block で报定したプロック中の， xm yp で指定した座樣のカラ—コー 
ドを ig します《 


ブロックへの点の書き込み 



ブロックからメモリへの読み込み 




S 式 


STATUS .blcTead(block, area, buff) 
HANDLE block [A] ブロックハンドル 

AREA •area [DE] ブロック内の領域 

char •buff [BC] 転送 5L アドレス 


[戻リ值丨 [A] OK 耘送成功 
ERROR fc 送失敗 


| W 说 1 block で指定したブロック中の area で措定されるエリアを，メインメ 

モリ上の領》の buff に転送します， 


メモリからブロックへの書き込み 



ブロックへの保存 


[ft 能番号 D 123 


HANDLE 


block U*] 
*area [HU 
xoffset [BC] 
yoffset [DE] 


ブロックハンドル 

保存するエリア 

ブロック内での横方向のオフセット 
ブロック内での縦方向のオフセット 


[M >) tt] [A] DK 保存成功 
ERRDR 保存失敗 


【解战 I area で指定した傾域を. block で参照？れるブロック内の xoffeet、yo&et 

で指定するオフセット（左上が(0,0)、マイナスは使用できない}分右下 
の領域に保存します. _«etblc() の*の«作を行ないます， 


ブロックから画面への表示 



ブロック内と画面の画像の交換 


[楼能#号] 


125 

STATUS ^vapblc(block, 
HANDLE block [A*] 

AREA (area [HL] 

UORO xoffset [BC] 

UORO yoffset [DE] 

[A] OK 交換戌功 

ERROR 交換失) IJl 


ブ〇ックハンドル 
画曲上のエリア 

プ〇ック内の横方向のオフセット 
ブロヴク内の抵V向のオフセ y 卜 


[ » M. ] area で格定したの Wffi 上の画像と. Wock で#照されるプ〇 y ク内 

の xofset. yoffset で指 i するオフセット分右Vの®域にある絵を交換しま 
す， putareaO と ■getarea() とを同時に行ないます。 


ブロックサイズの変更 
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グラフパック 


この章では、グラフパックの構成や使用方法.各ファンク >• 9ンなどについて说明します c 

13.1 グラフパックとは 

グラフパック《、 MSXView の現境を維持しながらウィンドウに対して、高速に描画する 
ためのルーチン辟です。グラフパックを使£ば、ペン，タイルのパターンや色などを自由に 
»定し-«や箱などの図®をクリッビングして描角することができます， 

MSXView では、文字以外の画 B 衣示はすべてグラフハ •-/ クを使用します（文字の衣示は 
フォントバックを使う〉。描画することができるのは、ウィンドウ環境の描画エリア（ズーム 
された領域）だけです，したがって、グラフックを使うときは、ディスブレイマネ_ジャ 
で描幽環境を设定して下さい • 描歯環境の設定については、ディスプレイマネージャの章を 
参照して下さい， 

13.2 グラフパックの使い方 

グラフパックを使って描画するときは、次のよつな手順になります。 

1. 描画に使うペンの R 性を8：定して、 _createpen() でペンを作成し，ペンハンドルを M り 
付けます。ただし、すでに存在するべ/ (システム«準ベン SYSPEN など）を使うと 
きは、必要ありません。 

2. 描画するウィンドウを- chwin()、jmshwinO などでカレントウィンドウにします。 

3. .chpenO, -pu8hpen() などで、使) H するペンを勿レントぺ〆にします。 

4. 表示を行なうエリアを _zoom() で、ズームします， 

5. グラフパックの描画フ7•ンク•〆3ンを使って、実際に描画します。 

6. .en«bsoom() で、描画状慼を終了します。 

7. 必要に応じて、 .poppen() などで，カレントペンを元に M します • 


描画の構成と機能 




13J 描画の搞成と嫌能 
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• タイルバターンデータ 

COLOR on; 

COLOR off, 

TINY pat[8] : 

} TILEr 

タイルスイッチ （TILE, bw ピット4、 5) 

0x00 pat の中をすべて 1 と想定して、 on で梢定した色で寄< 
0x10 pat 中のビット1の部分のみを、〇«で报定した fe で*く 
0x20 pat 中のビット1の部分のみを、 on で播定した色で宵く 
0x30 pat 中のビット0の部分を off で推定した色で、 

ビット1の部分を on で指定した色で窬く 


typedef etruct .grafpsn { 

TINY line [4]; 

TINY xhot; 

TINY yhot; 

TINY xs; 

TINY ysj 

TINY pat [8]; 

TILE bade; 

} PEN； 


/* 点級の，タン*/ 

/» X ホット灵縵ット */ 1 
/* Y li V |f ス，ット*/ 

/* X 4イ *J 
/» Yt -f *| 

/* ぺ H め■状 ■/ 

/* ぺ_ダ■ル！!/ 

/• 维 H つ•■.し■•イル*/ 

/• バク 6 イ ■ */ 

/* -eraseareaO など，* 

/. 1•面|ク -T するときに • 
/* ■用れ t タイル* 
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第 13 ® グラフノ<ック 


13.4 フアンクシヨンー覧 

グラフ■^ックには、 a 下のファ ンクシ a ンがあります。 


表 3.8 グラフパヴクのフアンクションー览 


166 

167 

168 

169 

170 

171 

172 

173 

174 

175 

176 

177 

178 

179 

180 
181 
182 

183 

184 

185 

186 

187 

188 

189 

190 

191 

192 


JSE 成 T 

ノ<レツ h _ «R"4i 

バレツトの摧得 
グラフパックの初期化 
ペンの設定 

描 B エリアの K 定 

図杉の fi なりをテストするモードの明始 

エリアの重なりをチストするモードの明始 

チストモードの終了 

ラパーパンドモードの明始 • 終了 

ラパ_パンドカラーの推得 

ペンの移 W 

点の描画 

線の描画 

四角形の描両 

中を塗りつぶした四角形の描画 
角の丸い四角形の描甬 
中を塗りつぶした角の丸い四角形の描画 
円の描两 

中を塗りつぶした円の描阃 
円 a の描® 

B 彩の描@ 

中を*りつふ•した®形の描画 
アイコンの描画 
指定色によるアイコンの描画 
上部のみ角の丸い四角形の描國 
多角杉の描画 

中を塗りつぶした多角形の描画 
エリア内のスクロール 
エリアの3ビー 
エ リアの移動 

エリアにしたがった四角形の描画 
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機能番号名前 


"T1 7- 


roundarea() 

pixel() 

-re«dbit() 


カレン F ペンに i る■"エリアの逛り""つぶ" L 
指定色でのエリアの生りつぶし 
エ iJT の塗りつぶし (OR) 

エリア内の.指定色の変 E 
エリアの塗りつぶし (XOR) 

エリアにしたがった角の丸い四角形の描画 
カラーコードの S 得 
エリ7■内の*ラーコードの K み出し 
エリアへの々ラーコ ー ドの ff き込み 
ェりアの移助 


437 

437 

438 

438 

439 
439 

439 

440 
43« 
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第 13 幸グラフバ/ク 


13.5 ファンクションの 説明 

ドでは、グラフパックの各ファンクションについて説明します。 

13.5.1 表記法 

フアンクン a ンの说明では、次のように表 id します。 


ファンクシヨンの 機能を示します 

[檐觴 * 号1 各 7 T ンクシ a ンに M リ丐てられている*冷です， 

I » 式 I fV 7? •ンクシ a ンを使用するときの S 式を示します。 

一7アンクシ3ンの屎0値の5? 

— 77•ンクシ3ン名 

—引 a 

ドウハンドル 
L- 91•の空味 

一引 B の受け*しに使われる CPU レジスタ 
(アセンプ，プログラミング W に使 

— 31 » 名 
一416の® 

[戾り ffi I そのファンクシ 3 ンの觔作の結果、どのような®が返されるかを 

示します • 

U3 0K 才■ブン成功 

ERROR オープン失敗 



‘«リ«の!8味 




13 5 7 7 •ンクシ 3 ンの Sft 明 
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グラフパックの初期化 


機能悉兮 

166 


OH ：] 

void 

.initgrai(void) 

「K り値| 

なし 


| W 說| 

グラフ'*ックを初期 f 匕します。ペン，フォント、ウインドウスタック 


PEN などを初期化します„このファンクシヨンはシステムが ft 勒的に突行 


するので、アブリケ'-シ9ンから呼び出す必要はありません • 

ペンの設定 


|機能番号| 

167 


1 ■» 式 1 

void 

8.tpenC P en) 


FEN 

•pen [HL] PEU«S 体へのポインタ 

| K ') (A | 

なし 


| M 说| 

カレ: 

〆 1 •ペンを pen で播定したペンに設定し、以後この形状で格画し 


ます. 


描画エリアの設定 

|機能番号| 

168 


^式 1 

void 

^lirect(ar«a) 


AREA 

• area [HL] ARE A W 造体へのボインタ 

|戻り iS | 

なし 


|解说| 

クり. 

/ビングエりァ（描画領域）を存接グ n —バル座揉で設定します。 


-direct() は、ウインドウ®境を改定せずにグラフパックを使うするための 
特殊なファンクシ3ンです。アブりケージョンでは使用しないで下さい， 



図形の重なりをテストするモードの開始 


[梭能番号丨169 


int xpos [BC] テスト座榇の横方向の位® 
int ypos [DE] テスト座樣の縦の f4 茜 


[戻り値 I なし 


[解说丨 このファンクシ3ンを实行してテストモ〜ドに入ると、以すべての描 

两フ T/ クシ3ンは笑際の描画を行なわず、 xpos, ypoi で«定した位 S が 
図形と S なるかどうかをフラグで返します。各描闽ルーチンは、 * なって 
いたら典を返します。 


エリアの重なりをテストするモードの開始 
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テストモ」 

-ドの終了 

|機能 St 号| 

171 

〇式； 

void -endtest(void) 

1戻り値1 

なし 

1 » Stt J 

テストモ--ドを終了します，以後，描两フ T ンクシヨンは実際に描画し 
ます。 

ラバーバン ド モー ドの開始.終了 

1檐能番号1 

172 

1 If 式 1 

void satrub(color) 

COLOR color [ A ] カラーコード 

| « 911 1 

なし 

|解说丨 

指定した色が 0 以外のとき、ラバーパンドモードに入り、以後描画フ T 
ンクシ a ンを其行すると，図形を color で指定した色の XOR で描画しま 
す。 PEN の設定は無视され， 1x1 のペンが使用されます。 

color に0を f 旨定して实行することで、ラバーパンドモードは籽了します。 

ラバーバン ド カラーの 獲得 

|機能番号| 

173 

| 备' 式| 

COLOR ^etrub(void) 

|戻 1 )値| 

[ A ] 色* 号 

| M 説| 

現在のラパーパン1••のカラーコードを返します， 
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事 13 車グラフ/ぐ》ク 


ペンの移動 



式」 


int xpos [ BC ] 横方向の n_ 々ル 座樣 
int ypos [0 E ] 縝方向の n — カ ル 座標 


「戾り値1 なし 

[解说] ペンを xpos , ypos で指定した位 SS に移助します。 


点の描画 

[楼能番号 175 

I S 式丨 BOOL .pset ( void ) 

「 R り値 I [ A ] テストモード時は、テストの結* 
[解说丨 W 在のペンの位 S に点を描きます。 


線の 描画 

[播能 S •号丨 176 

| 畜式"] BOOL ユ ine(zpos ypos ) 

int xpo P [ BC ] 横方向の口ーカル座榇 
int ypo P [ DE ] 璲方向の口ーカル座樣 

[戻り値 I 【 A ] テストモード時は、テストの結果 

[解说] 現在のペンの位 S から指定した位 R にペンを移助し，線を描きます。 



四角形の描画 

[機能番号 ’177 


BOOL .frame(zpos, ypos) 

int xpos [BC] 横方向のローカル座® 

int ypos [DE] 梅方向の口--カル座標 

[A] テストモード時は、テストの結* 

現在のペンの位®と、 xpos. ypos で报定した位笛を対角捸とする四角 
形を描きます • 


中を塗りつぶした四角形の描画 


178 


if 式 BOOL .box(xpos, ypos) 

int xpos [BC] 横方向の口ーカル座標 
mt ypos [DE] 战方向の O- カル座標 


[成り値 1 [A] テストモード時は、テストの結果 

「» 说| 現在のペンの位 a と xpos, ypos で推定した位 S を対角線とする、中を 

塗りつぶした四角形を描きます。 


角の丸い四角形の描画 



中を塗りつぶした角の丸い四角形の描画 


檯能番号 I 

苦式1 


匚 w a J 


int xpos [BC] 横方向のローカル座標 
int ypos [DE] 櫬方向のローカル座樣 

[A] テストモード時は、テストの結果 


円の描画 


「害式"! BOOL j>val(xpos, ypos) 

int xpos [BC] 檳方向の口ーカル座樣 
int ypos [DE] 战方向のローカル座« 

[戻り ffi 丨 [AJ テストモード時は，テストの結果 


中を塗りつぶした円の描画 


BOOL ^illovalCxpos, ypos) 

int xpos [BC] 横方向の口ーカル座樣 

int ypos [DE] 战方向の口一冷ル座標 



13.5 フアンクシ 3 ンの説明 
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円弧の描画 

[梭能番号. 1 183 


厂 畜式 - ！ 


int xpos [BC] 横方向のローカル座 KS 

int ypos fDE] 梅方向のローカル座揉 

TINY startangle [V]開始角度 

TINY andanglo [E*] 終了角度 



fR り値] [A] テストモ_ド時は，チストの結果 

「解说 startangle で报定された角度から endangle て•播定された角度までの円弧 

を，時計回りに描阃します，大き3は，現在のペンの位费と报定した xpos 
ypos を対角嫌とする四角形に内接する、円の一部となります。 


扇 形の描画 

[ at 能番号]184 


[ # X. 

[戻り_値] 


int xpos [BC] 横方向のサイズ播定 

int ypos [DE] 投方向のサイズ报定 

TINY startangle [A»] 開始角 K 
TINY endangle [E*J 終了角度 

U] テストモ _ ド時は，チストの結果 



「解说| startangto で指定3れた角度から、 endangle で播定5れた角度までの® 

形を，時計回りに描画します。大きさは現在のペンの位茜と指定した xpos、 
ypos を対角探とする四角形に内接する、円の一®となります， 



中を塗りつぶした扇形の描画 






式 


BOOL Jlllpai(xpos, ypos, startangle, endangle) 
int xpos [BC] 横方向のサイズ指定 

int ypos [DE] 縦方曲のサイズ栴定 

TINY startangle [A*] 開始角度 

TINY endangle [E >] 終了 ft 度 



指定色によるアイコンの描画 


[嫌 *6 # 187 





xsize [BC] 

ysize [DE] 

offcolor [E] 


_ アイミンパターンへのポインタ 
横方向のサイズ 
战"佝のサイズ 
オンビット色 
オフ K ット色 


[¢5 (£] なし 


[ « 说I 现在のペンの位我に、措定された色でアイコンを描画します。 


上部のみ角の丸い四角形の描画 


梭能番^ 188 


: ,*f 式 J BOOL index (xpos, ypos) 

int xpos [BC] 横方向の d — カル座樣 
int ypos IDE] 縱方向のロー々ル座橡 


[戾9依丨 [A] テストモード時は、テストの tt* 


「解说| 現 ft のペンの位 W と xpo«、ypos で很定した戴黄を対角線とする、上部 

だけ角の丸い四角形を描阀します a ペンの位»は移肋しません。 


多角@ A 描画 



中を塗りつぶした多角形の描画 


[檐能#号|190 


| 并式’ BOOL ^ illpolygon ( buff , num ) 

' POS «buff [ HL ] MS の®列へのポインタ 

int mm [DE] buff の POS メンバの滷数 


[成り® I [A] テストモード時は、テストの結果 


「解说| buff で示される POS の®列にしたがって、 numffl の項点を待つ中を塗 

りつぶした多角形を描きます。 M 始点と終了点は fl 勒的につなげられます。 


エリア内の スクロール 



115 77 ■ンクシ 3 ンの! ft»H 


エリアのコ竺二 — _ 

I 故能番なI192 

S •-式 I void _copy(xsizs, ysize, dx, dy) 

WORD xsize [BC] 横方向のサイズ 

WORD ysize [DE] 縱方内のサイズ 

Int dx [BC>] コビー宄の横方向の基点座標 

int dy CDE»] 3 ビ先の横方向の基点疰橒 

0 flftj なし 

「解址| 現在のペンの位逍を左上とする) oifcc, ysize の大きさを持ったエリアを 

dx. dy を左上とする戴 S にコビ••します。 


エリァ の移動 _ 

丨機能 S 号丨 193 

WORD xsize [BC] 横方’向のVイズ 
WORD ysize [DE] 银方向のサイズ 
int dx [BC] 横方向の転送! t 位 E 
int dy [DE>] 縱方向の Ik 送先位 S 

[庚り依丨 なし 

[解；) t 丨 垛在のペン位 R を左上とする xsize、ysize の大きさを持ったェりアを 

dx. dy を左上とする位 S に移抑します。移«1元の領域はカレン！•ペンの 
バックタイル（画面をクリアするときに使用される）で逭りつふ•されます • 



エリアの移動 




rz 


ZD 


AREA •area [HL] 移’勒元エリア 

int x [DE] 移勧先の«プ/向の位 S 

int y tBC ] 移先の榱方 Iffl の位 S 


K リ fA [A] TRUE トリガボタンで終了 

FALSE 7 ボートボタンで終了 


[W 说 1 エリアをポインティングデパイスの動きにしたがって移動させます。 aica 

に tt 初のエリアを、 x と y には最初にイペントのあった位 E のグローパル 
座樣をセットします。終了したときのイベントを _ungetevent() して戻るの 
で、必*に応じて他うか捻てるかして下さい • 


エリアにしたがつた四角形の描画 



カレントペンによるエリアの塗りつぶし 


void erasearealxsize, ysize) 
WORD xsize [BC] 横方向のサイズ 
WORD ysize [DE] 縦方向のサイズ 


指定色でのエリアの塗りつぶし 


WORD xsize [BC] 横方向のサイズ 

WORD ysize (DE] 崁方向のサイズ 

COLOR color [*] 々ラーコ-ド 


エリァの塗りつぶし ( OR ) 




エリア内の指定色の変更 

I檐能番号丨 19S 




WORD 

COLOR 

COLOR 


otaize [BC] 横方向のサイズ 
ysize [DE] 投_方向のサイズ 
srccolor [A 1 ] する々ラ--コード 

dstcolor [E’] 変更後の々ラーコード 


[SI 0 ffi] なし 

[解说 1 現在のペンの位 R を左上とする、 xsize. ysiie の大きさを持ったエリア 

内の、 srccoloi ■で指定した色を dstcol<ir で指定した fe に変更します， 


エリアの塗りつぶし （ XOR ) 



ェリアにしたがった角の丸い四角形の描画 


I 機能番号！ 

[r •) « ] 

[ » iti I 


200 

WORD xsize [BC] fit 方向のサイズ 
WORD ysize [M：] 縦方向のサイズ 

なし 

現在のペンの位 K を左上とする、 xsize. ysize の大きさを待ったエリア 
の外嫌に沿った角の丸い四角形を描画します。 


カラーコー ドの獲得 

「檐能番 201 

I 3F 式] COLOR -pixel(void) 

戻り板 I [A] * ラーコード 

[解说丨 現:&のペンの位 B のカラー:卜•を返します。 


エリア内のカラーコードの読み出し 





第13 «グラフ/，ソク 


エ义アニのカラニコードの書き込み 

能#号丨 2 D 3 


厂畜式 I 


AREA *aroa [HL] AREA 檐造体へのボインタ 

TINY *buff [DE] 害き込み元メインメモリへのポインタ 


[« ') ffi ] Kcl 


[解说： buff に格納されているデータを area で衍定した領域に® S 込みます <• 1 

ドットが1八イトのデータです • 


パレットの設定 

裱能 S 号] 4 




COLOR color [A] カラーコード 

RGB »rgb [DE] RCBfit 造体へのポインタ 


[SS り M] なし 

[解说 I color で ffi 定した*ラーコードのパレットを， rgb の内容にしたがって 

突®します。 


パ レツ トの獲得 



厂》式 1 I 


COLOR color [A] カラーコード 


RGB »rgb [DE] パレット構造体へのポインタ 


[戻り値 I なし 

f ^ , color で指定した*ラーコードののパレブト姑を rgb に返します。 



フォントパック 


この章では、フォントバックの供成や各ファンタンについて说明します • 

14,1フォントパックとは 

フォントパックとは、 MSXView で«商に文字を衣示するためのルーチン群です，基本的 
には、文字コード（シフト JIS コード）を与•えるだけで、文字を表示できます。したがって、 
MS-DOS マシンとの文并于•ータの交換が两单にできます。また，文字衣示の除には、さまざ 
まな飾りつけ（太字、斜体、輪郭，彩， M など> を*したり、大きさを変えたりすることが 
できます。 

MSXView では、梅数»«のフォン！•をディスク上に持つことができるので、ディスク上 
にデザインフォントを格 W しておき、必要に応じて、フォントパックを使用することで、さ 
まざまな宇体の文字を_に我示することができます。 

文字を*き込むことができるのは、 MSXView ウィンドウ堞堍の描画エリア（ズームされ 
た两域）です。7ォントバックを使用するときは、ディスプレイマネージャて-描画環堍を設 
定して下さい。描画環境の设定については、11苹「ディスプレイマネージャ j を参照して下 
さぃ。 

14.2 フォントパックの使い方 

フォントバックで文宇を表示するときは、次のような TW で热理を進めます。 

1. 表示するフォントの属性を狡定して、 -croatefontO でフォントを作成し、フォントヘンド 
ルを刺り付けます，ただし、 tT に#•在するフォント（システム樣準フォント SYSFONT 
など）を ft うときには，その必ではありません， 

2. 描 S するウィンドウを、 J*win(). .pushwin() などでカレントウィンドウにします。 

3. xhfont(). -|>uahfont() などで、使用するフォントをカレントフォントにします • 

4. 表示を行なうェりァをでズームします。 


5 jnovepenO で、文字の表示位 S を指定します。このとき、指定する位 S は文字の左上 
ではなく、文字のベースラインの左蟾になるので、注童して下さい。 

6. jdfontO. -dstr() などで、尖睽に文字を表示します， 

7. •endzoom() で、描«状®を終了します • 


8.必要に応じて、 _popfont() などで、々レント71•ントを元に戻します。 

9•必®に®じて、 .popwin(> などで、カレントウィンドウを元に戾します。 


14.3 フォントパックの構成と機能 

フォントバックで表示されるフォントおよぴ飾リつけは、7ォントテンブレートによって 
決定されます。また、7ォントメッセージにより個々の文字の大きさなどのフォントの情報 
を知ることもできます， 

次にフすントテンプレ-■卜について说明します • 


14.3.1 フォントテンプレート 


フォントテンブレートと，それによって決定される飾りつけについて tt 明します。 


/* Font template •/ 

TINY id; 

TINY width; 

TINY hight; 

TINY boldx; 

TIMY boldy,* 

TINY italic; 

TINY shadow; 
COLOR shadovc C4]i 
TIMY outline; 
COLOR outline。 [4]; 
COLOR underline; 
BOOL stripe, 

COLOR fcol； 

COLOR bcol; 

TINY pitch; 

TIMY logic; 

TINY direc; 

> FONT; 


/* フォント ID */ 

/* サイズ横ドット数*/ 

〆• 战ドット数*/ 

/• 太字 橹ドット数*/ 

/* «ドット数*/ 

/* 斜体 32»46度とする角度*/ 

/* 9# 数*/ 

/• 色，色，色，色《/ 

/• ♦&邦抜 》 */ 

/* 色色，色，色*/ 

〆*下繚 色*/ 

/» « オン*オフ*/ 

〆 *文字色色 •/ 

/* システム了•約*/ 

/* 文字問ドット*/ 

/* y ステム予約*/ 

/* 文字の回転、シフト JIS コード禁止 */ 
/* ブロボーシ a ナル祭止*/ 
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I ||LL シ x テ a 予約 

y ~■•シフト jis コード 
I 一■•■プロボーシ3ナル# J り 

■•■システム予約 


表 3.9 フォントテンプ V— 卜の内容 


名前 サイズ S 味 

id 1バイト フォント ID 

7ォント ID とは、7ォント7アイルの拡*+の r !j に統く文 
字です。その後の1文字は、フォントパターンの大きさを示し 
ます， 

フォントサイズ 
' ~►フォント ID 

- - 7ォントフ T イルであることを我す 

7 ォン！•名 

つまり、网じ7ォント ID であっても、大きさの逸う7ォント 
7アイルが存在します，7ォントバックは、使用できる7ォン 
卜77•イルの内で、もっとも適した大きさのフォント夕ーン 
を拡大縮' J、 して，金示します。フォント ID「Aj は、 MSXView 
專用の瑰字 ROM に割9内てられています。 
width 1パイト 7ォントサイズ（横ドット数） 
hight 1パイト フォントサイズ（縦ドット数〉 

フォントの縦，横の大きさを指定します • フォントのサイズは 
飾りつけをしないときの文字の大きさを指定します，太字など 
の飾 1 )をつけると、指定したサイズよ 1 )大きく表示されます。 
フォントパックは使用で S るフォントの中から、最速なものを 
自勧的に選び出し、桩大綰小して指定された大きさの文字を得 
ます。 

boldx 1パイト太字（横ドット数） 





1パイト太字（縱ドット数） 

指定した縦，横のドット ft 分、上と右に文字を太くします，し 
たがって、フォントックでは、太字は必ずしも1種類ではあ 
りません。あまり大きな ffi を与えると、文宇はつぶれます。 


outline 5 パイ！' 

stripe 1 パイト 

fcol 1パイト 

bcol 1パイト 

pitch 1パィト 

logic 1バイト 


蝓郭線 

文字の回りに指定した枚数、指定した色で袷邾をつけて* 
示します。輪郭は最大4璽までつけられます。 tSJIi 描の色 
は1本ずつ指定できます。 

下探 

文字の下に線を51#ます。下線はぺースラインの1ドット 
下に色をつけて、文字の蝠で91かれます。 

縞 

文字に縞の飾りつけをします • 

0 縞の》りなし 

0以外縞の》9つけ 
文字色 

文字色を指定します。縞の飾りつけモードに指定してある 
ときは1ドットごとに指定した色が、そうでなぃ場合はす 
ベて栴定した色が文字の色になります。 

システム予約 
文字面 

文字問 P0 をドット単位て•指定します。指定したドット数が 
文字の«に足され，的後の文字との m が•决定します， 
システム予約 
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«iiij サイズ +总味 

direc t：*/ 卜0,1システム予約 

ビット2 シフト JIS 3— ド禁止 

ビット2がオフのときは k シフト JIS コードで漢字を表示 （2 
バイトコードの1バイト目は何も表示しない〉します•ビッ 
卜2がオンのときは、アスキーコード（字角平仮名を含む> 
で表ポします- 

ビット3 ブロボーン a ナル禁止 

MSXView では、文字 li ブロボ—シヨナルスペーシング（幅 
が狭い文字11、文宇問 ra を誥めて衣示•印字を n •なうこと） 
されるのが tt 準です。しかし，アブリケーシ3ンによっては 
この®能が邪*になることも考之られるので、プロボーショ 
ナルスぺーンングを禁土することもできます。 

〇ブロポーシヨナルデータを持つフォントは、そ 
のドット数だけ文宇の蟠が狹まる。 

1ブ n ボーン3ナルスペー-〆ングを禁止する。 

ビット4一7システム予約 


文文文交文文 


凶33フォントパックの文字 



14.3.2 文字幅の計算 

文字の M は次のよ •> に針算します。 

• ブロポーンョナル時の文字蟢 

文字サイズ（テンブレートの横サイズ）+太字-ブロポーシ9ナル+文字間 
• ブロボ_ン9ナルなしの t きの文字18 
文字サイズ 

• 文卞明ブ n ポーシ3ナルなしのときの半角文字幅 

{文字サイズ+文字間）+ 2 (割 •) 切れない合は切揞て） 


14.3.3 フォントメッセージ 
フォントメツセーシのデータ供造は，次のようになっています。 


TINY s.base; ✓•元文字のベースライン*/ 

TINY s.width; /• 元文字の*サイズ*/ 

TINY s.hight; /* 級サイズ*/ 


TINY t.base; /»実際のベースライン*/ 

TINY t.width; /* 実際の横サイズ*/ 

TINY t_hight; /* 縱サイズ*/ 


TINY d_bas8； 
TIBY d_width 
TINY d_hight 
TIDY l_pitch 
TINY b.pitch 
FNTHSG : 


〆* 文字のベースライン（飾9つけ後 ）•/ 
/• 文字の最大横サイズ（飾りつけ後）*/ 
/* 棰サイズ（飾りつけ後） •/ 

/* 衣示が前にはみ出すドット R •/ 

/* 表示が後ろへはみ出すドット数*/ 


•define JISCOD 


WORD 


14.4 フオントフアイル 

14.4.1 フォーマット 

7ォント77•イルほ、次のような7ォーマットになっています， 
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14.4.3 フォントデータの計算 
フォン!•データ1文字分のパイト数の針» 

フォントデータ1文字グ)のパイI•数は、次の針 S 式で求めます， 

パイト数=(サイズ x サイズ +7)+8 
何文字入っているか 

フォントファイルに文字が何文字人っているかをは、次の叶算式で求めます。 

文字数=(ファイルサイズー,512)+ハ•イト» 

フォント77•イルを31んで， (froad) エラーが返ったら、その文字はないと判断すること 
ができます， 


プ〇ポーシ a ナルデータ 


1文宇1パイト 

r LLLLRRRRj のように、上位4ビットで左侧を，下位4ピットで右 (» の幢を指定し 
ます。 


• データの並び 



D 

T 


& 

S 

E 

U 







ファンクシヨンー覧 

■トバックには、以下のフアンクシ3ンがあります。 


金味— 

フォントハ •./ 

フォントスタイルの変更 
フォントパターンの搜得 
全角文字の幅の換得 
1文字农示 
全角1文字表示 
パターンの表示 
文字幅の*得 
文字列の表示 
文字列の«の搜» 

JIS コードによるフォントパターンの说み 


ファンクションの機能を示します 
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フォント パックの初期化 __一 

[梭能番号丨 133 

I 具 式 STATUS initfont(void) 

[戾り値 I [A] OK 初期化成功 
ERROR 初期化失敗 

[ « 说丨 フォントパックを初期化（漢 TROM のチ <■ ックやフォントスタイルの初 

期化など）します。このフ T ンク ya ンはシステムが0曲69に戈行するので， 
アブリケーシ * ンから呼び出す必要はあ9ません，ただし、アプリケーション 
内で闽而モ-ドの変 E をしたとき《、 jscreeuO が内部的に Jnitfonl() をコー 
ルしているので、 外字を正しく表示するために、 -initfont()^ 後で- initffilc() 
をコールしなければなりません， 


フォントスタイルの変更 

[根能#号]134 


[ » K 1 


FNTHSG * setfont(font) 

FONT *fon« [HL] FONT 供逢体へのポインタ 
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フオどトパターンの獲得 

| 檐能 Sg ] 135 

| 卉式 | STATUS _getfontpat(c, pat) 

char c [A] キャラクタコード 

char *pat [DE] パターンの返されるアドレス 

I 鉍 _) t£ ! [A] OK 成功 

ERROR 失敗 

I解説 I pa»tc で指定した文字のフォン(•パターンを返します。全灼义字（シ 

フト JIS コード）を指定すると IMS、.1 •.位パイト、下位パイトの期で_邊統 
して3 -ルします • 位バイトを指定したときは ERR » R を逛し、下位パ 
イトを指定したと i はパターンを»み込みます， 

全 角文字幅の獲 得 

[機能# V 1136 

| 备式 | TIKY Jtnjwidth(sjiB) 

WORD sjis [HL] シフ！ 'JIS コード 

I 斑り® 1 CA] 文字幅 

[觯说： sjis で衍定したシフト JIS 3_|••の全角文字の蟠（ドット款）を返し 
ます- 



14.6 フアンクシヨンの銳明 453 

1 文字表示 

I機能番 y_ 1 

137 

1占 式： 

void .dfont(c) 

char c [A] キャラクタ： 》— ド 

|戾〇姐| 

なし 

1 «说 1 

C て•报定したキャラクタコ••ドにしたがって1文字表示を行います•シ 
フ ！• J1S® 字コードの場合にも、上位パイト、下位パイトの順で連統して 
コ••ルすると、 fl 動的に表示されます • 

全角 1 文字表示 

|拽能#号| 

138 

1 ® 式 1 

void dkanji(sjis) 

WORD sjis CHL] シフト JIS コード 

: 戾り ® | 

なし 

I 解说 I 

シフト J1S 3— ドで文字を1文字*示します. 

パターンの表示 

1 機能番号| 

139 

1 Tf 式 1 

char *pat [HU 表示するパターンへのポインタ 

| m >)1® | 

なし 

|解说1 

現在のフォントテンブレートにしたがった»りつけをして、 pat で指定 
したパターンを表示します。 _dpattem() は、外字や D ゴ（アイコン > な 
どに»りつけして、表示させるためのフ T ンクシ3ンです。ここで指定す 
るノ 夕ーンは、現在使用しているフォントと同じ大きさでなければなりま 
せん。 



文字幅の獲得 


[嫌能*，]140 

し客式] TINy .chruidth(c) 

J char c [A] キャラクタコード 


I 庚り® [A] 文字幡 

[解说 c で指定した文字の幅を返します•全角文字（シフト JIS 3- ド）を指 
定するときは、上位パイト、下位パイトの顒で*校してコールします。上 
位パイトを指定した t きは0を返し、 T 位バイトを指定したときは結果を 
ig しま1% 


文字列の表示 _ 

[梭能 S 号]141 

| # 式 | void _dstr(str) 

char *8tr [HlJ 表示する文字列 （0 夕ーミネイト > 

I 戾り値] なし 

[解说： str で指定した文字列を表示します，内部的には、文字列中に0があら 

われるまで、繰り返し _dfont() をコールしています。 

文字列幅の獲得_ _ 



JIS コードによるフォントパターンの読み込み 


[_ 嫌能番号I146 


[S 式！ STATUS _gBtjispat(jis， pat) 

WORD jis [HL] JIS コード 

char *pat IDE] パターンがはいるところ 


[庚り ffl I 



成功 

失敗 


[解 K I pat に、 jis で报した JIS コードに相当する全角文字のフォントパター 
ンを 説み 込みます。 


フォントファイルアクセスの初期化 


榷能礬号丨 147 

I 卉式 | void initffile(void) 

[R ') ffi] なし 

[W Si ' フォントフ 7 ■イルアクセスのために初期化します。このフ r ンクシ a ン 

はシステムが自動に実行するので、アブリケー zs ンから呼び出す必要 
はありません。 


外字ファイルの読み込み 



运章 

テキスト マネージャ 


この*では、テキストマ丰ージャの«成や各■フ？■ンクン》ンヒついて說明します • 

15.1 テキストマネージャとは 

テキストマネージャは、 MSXView で文字列の入力や編*を行うためのマネージャで1% 
テキストのフォーマットを播定することにより、左寄せ、右寄せ、センタリングなどを没定 
することができます。 

テキスト蟠集を行うためには、以下のよつな情報を含むテキストテンブI卜を使用し 
ます。 

• テキスト»集を行うウインドウ 
テキスト*集を行うウインドウを指定します。 


テキスト《«領域の位策と大きさ 

テキスト》策®域をウィンドウのカル座樣で指定します • B 本 Sg 入力の候 M 表示 
も、この領域内で行われます。 

テキスト編集で使用するバッファへのポインタ 

テキストマネージャを使用して文字列編集を行うためには、文字列を格納するための 
バッファ（テキXI■パッ 7T) を RAM 上に確保して、そこへのポインタを与えなけれ 
ばなりません。 


テキスト編集用のバッファの大き S 

テキストマネージャが使用できるテキストバッ77■の*さを指定します。 


• テキスト* SS で使啪するフォーマット悄報 

テキストマネージャに左寄せ.才 i 寄せ，センタリングなどを行う根能があり、その 
フォーマツトを指定するだけで、自勒的に表示行取位のセンタリングや右寄せが行え 
ます（左寄せとは、通常の文字列人力)。ただし、1つのテキスト内で.供数の7ォー 
マ y 卜を捎定することはできません。 


• H 本； S 人力を使用するかどっかを示す衍轵 

入力を H 本 S で行うかどうかを指定することができます„ 

• テキスト# sm で使用するフォント悄報 

テキスト編集で使用するフォントを报定します。ただし、11+語>7_|>*ブロセ.ノサの 
ように搀数のフォントを1っのテキストの中に共存することはできません • 

•テキスト JS* 可能な«大行数 

テキスト &ijfe で行数制限を a けると s に使用します • ri 数制限がいらないときには、〇 
を指定します。 

，以下は.アブリヶーシ3ンが初期設定する必要のない情報ですが.萵速化やアブリヶーシ3 
'での利用のために，テキストチンプレートの中に含まれています， 

• テキスト緘东パッフ7•終«への, "K インタ 
• テキスト*集パッフ7■内のテキストの行数 


• 現在表示されているテキストの先頭行 


• 力ーソル位 s へのポインタ 
• カーソルの綸釋X、 Y« 棵 
• レンジ进択されている锸城の先頬へのポインタ 
• レンジ®択されている領域の終«!•へのポインタ 

また、 H 本;3を使う7•プりケ_ン 3 ンのために、かな*字変換フロントエンドブロセッサ 
インターフ i イスが組み込まれ、简平な指定を行うだけでかな漢字変換が使用できるように 
なっています。 H 本シフト JIS コ■ドで ff 理されるので， MS-DOS のテキストファイル 
などと、デ_夕を交換することができます， 

15.2 テキストマネージャの使い方 

MSXVicw アプリケー ys ンで、文字の入力や®*をするときは、次の手«で進めます。 

1. テキスト te* のためのウィンドウを作成した後《テキストバッファに«集するテキス 
卜を入れて、テキストテンブレートを設定し、 _c r eatetext() でテキストを作成し、于 
キストハンドルを取得します， 


2. _disptext() を使用してテキストを初期化して表示します • 


3. 編集対象とできるのは、全函播中で1つのテキストだけなので、どのチキストを編集 
対象とするかを、 _chtext(), _pushtext() で指定します。 _chtext(), 4>ushtext() をコー 
ルすると、 そのテキストの* —ソル位 S にウィンカを用いたテキストカ_ソルが表示 
されます。 



テキストマネージャの構成と機能 



HANDLE 





font; /* 使用するフォントハンドル*/ 

line; 

以下はアブリケ…ションが«定しなくてもよい悄報 **•«***/ 


•cursor; 


/* バッファ終®へのポインタ*/ 

/»バッファに格納されている行数*/ 
/* i 示されている ibSM? */ 

/* 力ーソル位$へのボインタ*/ 

/»々ーソルの途埋X座松*/ 


char *rang«-, 

char •andrangs-, 


〆•カソルの綸理 Y 座標* 7 

/* 逛択されている領域の先败へのポインタ*/ 

〆*遒択されている領域の終*へのポインタ 


表3.12テキストテンプレ-'卜の内容 


名刖_ fi 味_ _ 

win テキスト碥隹»域の存 fr. するウインドウハン|••ルです， 

area テキスト縝东領域をローカル座揉で格納します。 

buff テキストパ，/ファの先败へのポインタです。 

テキストマネ-■ジャを fA 用するためには、テキストを ff 理するためのテキ 
ストパッ7 r を RAM I•.に確保しなければなりません • 

テキストマネージャは、テキストパッファの先败から*菜対象となる文字 
列を格納します。文字列は ASCII (H 本焐はシフト JIS) コードで格納さ 
れます。改行； 3-1 ••は LF (0AH) の1文字けです (CR, LF ではない >• 
テキストの終 ffi は0で表します。つづけて、テキストバッファの終端から 
先奴に向かっての各表示行の先通へのポインタと各表示行の®を格納しま 
す。この2つの要索は1行につき4バイトずつ使いますが、この情報によ 
り各®の sta が格段に高速化で s るため、パッファ内(こ保存しておくよう 
になっています。 

データの管 a が、このように1つのバッファを共用する構造になっている 
ので、アブリケーン a ンは1つのバッファを用意するだけでテキストを*! 
理できます。 

length テキストマネージャが使用することのできるテキストパッフ r の ft さを示 

します。テキストバッファは上紀のように使用されるため、•^ッファの長 
さは以下のように at 算して下さい- 

length=< 編集する最大文字数>+1+<編集す S 最大行数+2> X4 
<縝集する S 大文字款>11；日本語の場合1文字で2バイトとなることを 
考慮して決めて下さい。 



ます。単!?®緑などの特殊用途に使用します。 
アイテムセレクタとして使用します_ 



名前_ ffi 味_ 

.column 勿ーソルの理X座*を格紡するための領《です， ；>- ソんが移動する度 
に自 ft 的に攻定されます（ただし，シフト J1S の澳字では、2ずつ;！むよ 
うに数又ています。つまり、行«からのパイト数を示しているので注*し 
て F さい). 

row 办ーソルの論理V•座標を格納するための領域です。カーソルが移動する度 

に ftW 的に設定されます„ 

raT«e 迸択されている®域の先«へのポインタを格納します0領域選択が行われ 

ていないときは * NULL を格納しています。 
endraiige 選択されている領域の終端へのポインタを格納します ■> »»邁択が行われ 
ていないときは、 NULL を格納しています。 


15.4 テキストコントロールの使い方 


テキストコントロールと li, テキストマネ—ジャの檐能を利用して、テキストをコント 
〇—ルと L て®用することです，テキスト7ネージャは、3ントロール*号15の«準コン 
卜〇-•ルとして剌9付けられており、テキストパッ77■の内容を表示したり、ポインテイン 
グデバイスによりカーソルの位 B を指定することが、コントロ-ルマネージャで行えます。 
ただし、キ-'ボードから入力された文字の®理は、コン-トロールマネージャではイ;可能なの 
で、必ず -writetextO と •chtaxt() を使用して下さい。 

テキストコント〇—ルは、カレントテキストを0勑的に切り換えるので注意して下さい • 
,diapcntl(). .trackcntlQ などで、カレントテキストが切り換わることがあります。 


15.4.1 コントロールテンプレートの形式 
コントロールテンブレートは、次の t うな»式になっています。 


typedef struct _ctrltp { 

HANDLE number; 
TINY sv; 

int yp 

WORD za 

WORD ys; 

HSG *msg; 

> CONTROL; 


/• 

/* 

/* 




ここに设定しておいた*リアが 、 */ 

テキストテンプレートにコビーされる。 */ 

コン！■ロールメッセージテキスト*/ 
ハンドルを入れておく （ただし 、•/ 
.createtextO しておかなければならない> */ 


コントロールを使うと、次のような利点があります • 
«テキストテンブレー！■の作成を®略化できます。 



ファンク-〆ヨン名機能 




dispcntl() 


-findpart() 


trackcntl() 




.ctosecntlQ 


Jispcntl() では，テキストの初期化!®;琛を行うことができますが 
このとさ衣ボも行われてしまいます， -«pencntl(l では，内部の初期 
化のみを行うので、衣示したくないとき（待に、 jedisptext() で途 
中から表示したいとき）に使用します。テキストテンプレートにコ 
ントロールテンプレートの win フイールドや area フイールドをコ 

ビーする点は、 •iispcntiO と同じです。 

JisptextO と同じことができます。3らに、々レントウインドウを 
播定されるテキストテンプレートの win フィールドにコビーし、コ 
ントロ-ルテンプレート内の有効エリアフイールドをテキストテン 
ブレー!•の area フィールドに3ピーします。したがって，テキスト 
テンプレートを作电する手 W が省けます ■ 

常に 80H を S します。これは，テキストコントロールが1つのパー 
卜から成 1 )立つためです。 

コントロール内でポインティングデバイスがクリックされたときに、 
このルーチンを呼んでテキストコントロールを芙行させます。 Is いボ 
タンが離されるまで制御は戻ってきませんが、押してすぐ離すとテ 
キストカ—ソルを移動し、押してからポインティングデバイスを移 
動 S せると、領域坩定（レンジ*択）を行います， 

テキストコントロールがレパ—だけで構成されるので，何もしま 
せん。 

-ditext(0) と同じく、 B 本謾入力をキヤンセルします。 


15.5 アイテムセレクタとして使用する方法 

ここでは、テキストマネージャをアイテムセレクタとして使用する方法を说明します • 
アイテムセレクタとは、いくつかのアイテム（項 g> から1つのアイテムを選択するため 
の ユーザー インターフェイスで、フ T イル名の*択などに用いられます。選択するアイテム 
か少ないときは、単独で使いますが、アイテム数が多■いときは.スクロールバーといっしよ 
に使います。 
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MSXV_icw では，テキストマネージャを使って、アイテムセレクタを面単に作成すること 
がてきます。 

テキスト構造体をアイテムセレクタとして使うには、テキストバッファに選択すべきアイ 
テムを LF (\n) で K 切って準«しておきます （St 後のアイテムには， \n は不要)。また、 opt 
フイール h •のアイテムセレクタビット（ビット12> を立てておきます。 

上を準備した上で， xreatctcxt()、jlisptrat() を実行すると、アイテムセレクタが衣示 
されます。アイテムセレクタをテキストコント〇— ルとして tit 定しておき、テキスト3ント 
口—ル内がクリックされたときに- trackoitlO を呼び出せば、ボインテイングデパイスを使つ 
てアイテムを選択することができます。迸択されているアイテムは1»のウインカ（テキス 
卜力ーソルウィン々）で示されます，ただし、レンジ指定を行うことはで#ません， 

また、キーイベントを _writet«ct()U 入れると、力ーソル上 'F. ページ送*)，ページ8?し， 
終瑞、行送り、行戻しなどのフ T ンクシ3ンが*能します（神入や削 B；、 力ーソル左 
右移助、レンジ送択などは行えない），これらのキーアサインはすべてテキスト«来と共通 
(キ—マップによって決定される〉なので、ユーザーは党えやすくなっています。 

15.6 スクロールバーのリンク方法 

次に、テキストマネ*-ジャとスクロール一のリンク方法を说明します。 

テキストマネージャで管理する緇疋テキストの&が增えたときは、テキストにスクロール 
パーをつけなけれはなりません。 MSXView のテキストマネージャでは、以 T のような！*！単 
なノ/法で、スク〇-ルバ-をつけることができます。 


15.6.1 スクロールパーの処理をテキストに反映させる方法 

• スクロール7■ヅブ7•イコン （▼) をクリックしたとき 
.texteditfunc(CURSORLINEDOWN) をコールして，テキストをスクロールさせます. 
技けて jcrolltextO を実行しなければなりません„ 

• スクロールダウンアイ3ン （▲) をクリックしたとき 

.texteditfunc(CURSORLINEUP) を:!'-ルして、テキストをスク〇 -ルさせます。枝 
けて _scroUtexl(> を*行しなければなりません， 

• スクロールボックスをつかんで移動したとき 

スクロールパーテンプレート内の cumum フイールドを使って表示先頭彳7■を求め、 
■redisptext(curauin) をコールしてテキストを再表示します。 


15.6.2 テキストのスクロール処理をスクロールパーに反映させる方法 

writetext(). Jexteditf»mc{) をコールしたときに、 ERROR が返ったら、スタ。ールが必 
要です。 _scrollt«t() を呼んで、スク〇-ルして下さい。 

スクロール®理の f 金に、テキストテンプレートの lines フイ-ルド < 全テキストの行数）を 
スクロール / <—テンプレートの maxnum フイール KC、topline フイールド（表示されてい 



を再*示して下さい， 

スクロールパーの pagenuin フイールドに対|£するテキストテンプレートのフイールドは 
ないのでテキストエリアの Y サイズを、テキスト便用しているフォントの®さで割って. 
1ぺージに表示されている行数を求めなければな9ません。 

15.7 フアンクシヨンー覧 

テキストマネージャには、以下のファンクションがあります。 


表 3.14 テキストマネージヤのフアンクシ3ン ーK 


264 Jiiittcxthd() 

265 .createtext() 

266 disptext() 

267 ,deletctext() 

268 .currenttext() 

269 ,chtext() 

271 .pushtext() 

271 .poptcxt() 

272 ,textadrs() 

273 ,writetext() 

274 .texteditfunc() 

275 Jocatetext() 

276 jsetcursor() 

277 .scrolltext() 

278 jedisptext() 

279 .inserttext() 

260 jettcxtcarsorO 

234 JushJsystemO 


テキストハンドルの初期化 467 

テキストの作成 467 

初期化をともなうテキストの表示 468 

テキストの削除 469 

カレントテキストの梅彳5 469 

々レントテキストの変® 470 

保存をともなつ;^功レントテキストの変 K 470 

テキストの愎帰 471 

テキスト構造 f 本の®得 471 

テキストの»集 472 

«瓤フ7•ンクシ3ンの実行 472 

テキストカーソルの移助 473 

バッファ中のテキストカーソルの移魴 473 

スク D —ル >5* 474 

テキストの再*示 468 

文字列の神入 474 

テキスト截 S の议定 475 

漢字変換のキャンセル 475 




ファンクシヨンの機能を示します 



_ va ンの圾明 


テ f ストハンドル初期化 一 _ 

丨槻能番号| 264 

[甚式 void inittextbd(void) 

I庚 |J 値丨 なし 

[解说I テキストハンドルを初期化します •このフ r ンクシ9ンはシステムが S 

«的に戈行するので、アプリケーン9ンから呼ひ■出す必要はありません， 







初期化をともなうテキストの表示 


機能赛号I 266 

[^嗇 _ 式」 STATUS disptext(text) 

HANDLE text [A] テキストハンドル 


「厌り値， [A] 表示に失敗した場合 _R 

| W 说| テキストテンブレ'-卜を初期化して、テキストパッフ T に文字または 

文字«が入っていると Sli、 それを S 示します • テキスト®生•を行うため 
には、あらかじめこのフ r ンクシ3ンをコールしなけれ If なりません，内 
部的には、このファンクシ3ンは行®ポインタ，行の輻などを初期化しま 
す。テキストをコント〇_ル（後述）として使うときは、 j«spcntl() また 
は- dispalkintlO でテキストを表示することができるので、 -disptext() を 
コールする必要はあません。 


[JL SI 表示をしない初期化を行うには、力 pencntlO を使用して T3 い。 


テキストの再表示 


[機能番号’ 278 


厂签式1 


STATUS ^edisptext (line) 

WORD line [HL] 表示開始行 
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469 


テキストの削除 

[楼能#号] 267 

I 县式 1 STATUS delete text( text) 

HANDLE text [*] テキストハンドル 

〔反り値 _ [A] 失敗した場合 _R 

[K % I text で析定したテキストを削除します • また、削除するテキストがカレ 

ントテキストになっている場合には、ウインカや B 本 SS 変換候補ウインド 
ウも同時に消去します， 

カレントテキストの獾得 _ 

[棰能* W 268 

I 苔式丨 HANDLE -currentcezt(void) 

I H り依 j [A] テキストハンドル 

[觯说丨 々レントテキストのハンドルを返します， 
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カレントテキストの変更 

厂橹能#皆] 269 




STATUS chtext(tezt) 

HANOLE text [A] テキストハンドル 


[^ ') «] [A] OK 変更成功 

ERROR 変史失敗 


〔解说I 々レントテキストを text で析定したテキストに変更します。このとき、 

テキストウイン* (テキスト*—ソル）を指定したテキスト中に移觔5せ 
ます，ただし、ハンドルとして0を指定したときは、入力をキャンセルし 
ます，かな漢字変換が途中であれば、変換候褸表示ウインドウを閉じて 
変換候補を袷てます。 

テキスト編菜を終了？せるときは，必ずこのフ r ンクシ*ンをコ-ルし 
てください • そうしないと、かな漢字*換ウインドウが M いたままになっ 
てしまうことがあります。 


このファンクションでは，初期化されていないテキストをカレントテキ 
ストとすることはできません0必ず- disptext()、>di8pcntl()、.opencntl() 
などで、テキストを初期化 （U 規ポインタ、行蜢テーブルの初期化）した 
後で，コ_ルして下5い • 


保存をともなったカレントテキストの変更_ 

能番兮丨270 

| # 式"! STATUS -pushtext(text) 

HANDLE text [A] テキストハンドル 

[B! Oft] [*] OK 成功 

ERROR 変. (C 失敗 

[解 jft I 冷レントテキストをスタックに枏 A. text で捎定したテキストを？ > レ 

ントとします。 
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テキストの復帰 

: 機 

271 

L * « 1 

STATUS -poptext(void) 

Ik •) ffij 

[A] OK 復袖成功 

ERROR 復《失敗 

1 w 说1 

テキストハンドルをスタ •/ クから取り出し，カレントテキストとしま 
す。 -piwhtext() と対にして使用します。 

テキスト構造体の獲得 

|機能®号| 

272 

丨番式 1 

TEXT •-taxtadrs(text) 

HANDLE text [A] テキストハンドル 

Id 0 « | 

tHL] テキスト WiS 体のアドレス 

解说 1 

text で指定されたテキストの実体である， TEXT 構逝体のアドレスを 
返しま* 1 



テキストの編集 


@ 能 S 号 j 

nr^~\ 

[庚り ] [A] キーマップ：！ード 

匚 W JJi 


ント供造体へのポインタ 


泠レントテキストに対してキーイベントを送ります。これにより、テ 
キスト蝙集が行われます。カーソルがテキスト表ボエリア外に出てスク 
口--ル逛理が必要になるか、 IESC〕 キーが押されるか，行数•パッファ祥 
设などの制限によリ^]キーが擇人で s なかったと s に，〇以外の値（纗 
16キーファンクン a ンのキーマップ3— ド> を返します，戾リ姐が〇以 
外のときは、_80"0«1〇11()をコールしてテキスト表示エリアをスクロール 
させなければなりません • このとき必要であれば，スクロールパーを并 
き換えます <_scroUtext() を独 ft させているのはこのため）。戻り値とし 
て，キーマップ 3 —ドが返るので、1*»1キ-ゃ 「ESCI キーなどが押され 
たことを利断することができます。これを利用して、1行の編诋級作で、 
RETURNKEY <keydefs.li で定義されている）が返ったら担集が奸了した 
と W 断し、 ESCKEY が遇ったら中断するというような班琛ができます。 

r ^ S- 1 _scroIltext() は、 -writetext() から0以外の値が jg ったときに、コールし 
て F さい • «に ■scrdltextO をコールしていると、日本 iS の候補表/调城 
にテキストカーソルウインカが点滅するなどの問明が出ることがあります， 


編集ファンクシヨンの実行 


機能番号| 274 


[炭り’ U] 力—ソルがテキスト領«外に出たら ERROR 






[A] 力ーソルがテキスト領《外に出たら ERROR 
column と row でした位3にテキストカーソルを移動させます。 


ァ中のテキストカーソルの移動 


スクロール 処理 


[機能»号 


277 


BOOL .scroXltext(scrollbar ) 

CONTROL »scroUbar [HL] スタ o —ルバーコント o— ルへの 
ポインタ 


[A] TRUE 
FALSE 


其際にスクロール feflt が行なわれた 
Xクロール SiH! は行なわれなかった 


[W 说I カレン!•テキス（•のカーソルが SBS 内(こなるように、スクロール％理を 

fr います。このファンクン3ンでは.雄スクロールバーを更斬することが 
できます。 scrollbar に播スクロールパーコントロ _ルへのポインタを指定 
すると，スクロールが牛•じたときII,自抽的にスク D —ルパーコント〇— 
ルを®新し、スクロールパーを再表枳します • scrollbar に0を指定したと 
きは、スクロールパーの史新)&理 li しません • 


文字列の挿入 


>能*号 279 


ff 式 I BOOL ^nserttext(pt r , taxt) 

一 char »ptr [HL] テキストパッフ 7 ■内のア I ••レス 

char *str [DE] 文字列へのポインタ 


[«_') at" 1 [A] TRUE 神入が行なわれた 

FALSE 神入は行なわれなかった 


[ « ptr で指定したカレントテキストの位 R に， str て•析定した文字列を押入し 

ます。 ptr は^必ずテキスト <• ■{ッファ内を指し、 text は0で終了するシフト JIS 
文字《でなければな 1 )ません•通常は、この後で、 -texteditfunc(SETCURSOR) 
をコールして，カーソルを移抑 S せてド5ぃ《 



テキスト位置の設定 


能番 1 1 280 

と 式 | STATUS settextcursor(*pos, ypos) 
int xpos CHL] hi 

ia.t ypos [DE] de 


「戻 ， 】 狼] [A] iffi 定に失敗したら EHROR 


[解说 I カレントテキストのテキスト々ーソルを xpos, ypos で指定した位 a に 

a 定します。 


漢字変換のキャンセル 



16 章 

リソースマネージャ 


ここでは、リソ_スマネ — ジャの供成や各フ T ンクシ a ンについて说明します。 

16.1リソースマネージャとは 

リソースマネージャ li MSXView で統一的にフ T イルを苷理するためのマネ--ジャです • 
•■リソース」とは、「資«』のことです。 MSXView で«、デ •< スク上にファイルとして赛え 
られているさまざまな悄報のことを指します， 

MSXView では、フ T イルをアクセスするときは、リソースマネージャを使います。 MSX.- 
DOS プ〇グラムに見られるような、5番地 3 -•ルによる MSX-DOS の S： 接呼び出しは行い 
ません， 

同時に，リソースマネージャは、手問のかかるエラ ー»!： 理などもサポートしています。一 
tt 的には. MSXDOS では、アブリケーン3ン内でのエラ_坧理は面倒ですが、このりソー 
スマネージャを使うことによ0、エラ-•メッセージの表示からリトライの実行示まで、ア 
プリケ ーS/3 ンの M 発にはほとんど負荷がかかりません • 

また、リソースマネ--ジャは，通常の >«SX-DOS ファイルシスナムの呼び出し檐能の他 
に t ft 大 64K パイトの7ァイル，<ッファを苷獲できるファイルア〇ケータ檐能を僱えていま 
す， MSXView では、アプリケーシ3ンプ〇グラムのデータエリアが 32K パイトなので、大 
きなデ-■夕はファイルア〇ケータを使って、ディスク上に取らなければなりません。 

また、オーパーレイプログラムの実行をサボ_卜するための根能もリソースマネ'-ジャが 
管*しています • MSXView では，アブリケーシ s ンエリアが小さいので、大規模なアプリ 
ケーシ3ンは才•■パーレイを使うことになりますが、リソースマネージャがオーパーレイに 
関する処理をほとんど行なうので，オー •*<- •レイにともなった領域の待避なども含めて、多 
重の才—パーレイ（オーパーレイブ〇グラムで別のオーパーレイを行なうなど> を使用する 
ことができます， 


16.2 リソースマネージャの使い方 

リソースマネージャは、フ7•イルアクセスに两するいろいろな目的で活用されるので，そ 
の使用方法はさまざまです。ここでは、リソースマネージャの使用方法を、タイプ別に分け 
て説明します。 

16.2.1 通常のファイルをアクセスする方法 

通常のフ7•イルを铳み寄きするには、以下のよつにします。 

1. ます、ファイルをオープンします。ファイルを才ーブンするには、 Jopen() を使用し 
ます。新規にファイルを作成するときは. JcreateO を使うこともできます， .fopen(), 
JcrcateO を:》—ルすると、ファイルハンドルが別り付けられます。以择のファイルは、 
このフ T イルハン►•ルでアクセスします。 

2. ファイルをアクセスするには、そのファイルをカレントファイルにしなけれ li ■なりま 

,カレントファイルを切り換えるには、 -chBleO、jmshfUeO などのファンクショ 
ンを使用します。 

3. フ T イルの说み*きには、 Jread()、•fwriteO を使います。 

4. ファイルアクセスが終了したら，；>レントファイルを元 p 戾します。 _pushfile() で;>レ 
ントフ7■イルを切り換えておけば、 -popfite() でカレントファイルを元 lc 戻せます。 

5. Jdose() でファイルをク〇_ズします。 

16.2.2 ファイル上にデータエリァを確保して使用する方法 

MSXView では、大 fi のデータはディスク上に確保するのが一般的です，したがって， 
MSXV^ew CU, ファイル上にデ-タエリアを tt 保するために、ファイル上の傾城割り付 
けを行なうファイルアロケータが用 S されています。 

フ7•イルア〇ケータは、以下のような手I供で使用します。 

1. 作業用ファイルを JfcreateO などで作成;します。また、ファイルアロケータはカレント 
ファイルに対して有効なので、 _chfife()、_push8e() を使用してカレントフ7•イルを切 
り換えておきます。 

2. Jnitfalloc() を使用して、ファイルアロケータを初期化します。 

3. 領域の別り付けが•必要になったら、 Jalloc() で®域を割り付け、割り付けられた領域が 
不きになったら、 _ftee() で領域を解放します。 

4. 割り付けられた領域をアクセスするには、 J'allocO で領域の先頭へのポインタ（フ7•イ 
ルのアクセスポインタなので、 long® になる）を受け取り、 JseekO でその領域をアク 
セスできるようにしておき、 Jread() % jfwrite() でアクセスします。 

5. ファイルアロケータを使用し終わったら、カレントファイルを元;に戻し、ファイルを 
ク〇— ズします。 



16.3 フアンクシヨンー覧 

リソースマネージヤには s 以下のフ7ンクシ a ンがあ9ます， 


表345りソーXマネージャのフアンクシ*ンー ffi 


^etdnve() 

.getdnve() 

.eetfileinf6() 

.getdiskinfoO 

fset() 

-fopen() 

JcloseQ 

Jcreate() 

Jddete() 

.chfile() 

pu8hfile() 

.popfile() 

■fwiiteO 

.fread() 

Jseek() 

.fpoint() 

-feize() 

jnsxdos() 

jnitfalloc() 

ialloc() 

-ffree<) 

.absread() 

,choice() 

.format() 

,currentfile() 

jnitoverlay() 

.junipO 

.exitmoduleQ 




V- スマ#—ジヤの初期化 4§5~ 

デフォルトドライブの設定 482 

デフォルトドライプの榷得 483 

ファイル tS 報の搜得 483 

ディスク情報の搜得 484 

フ7•イルの検索 485 

次のファイルの検索 486 

ファイルのオープン 487 

ファイルのクローズ 487 

ファイルの新規作成 488 

ファイルの W 除 488 

7T イル名/ディレクトリ名の変 E 489 

カレントファイルの设定 489 

保存をともなう汐レントファイルの変 R 490 

レントファイルの徂嫌 490 

カレントファイルへの書き込み 491 

カレントフ T イルからの!#み込み 491 

フ T イルポインタの»定 492 

ファイルポインタの®得 492 

ファイルサイズの S 得 493 

エラー：3— ドの理锝 493 

MSX-DOS2 システムコールの実行 494 

フ T イルアロケータの初期化 404 

ファイルバッフ T の應得 495 

ファイルパッフ T の解放 495 

論《セクタによる H み出し 496 

デ•(スクフォーマ •>> トメッセージの灌得 496 

ディスクのフォーマット 497 

カレントファイルの播得 497 

オーパーレイマネージャの初期化 498 

オーパーレイモジュールの実行 499 

MSXView アブリケーシ s ンの起動 500 


才 一 /<—レイモジュール•チャイルドプロ 
グラムの強制終了 



推能番兮名的 Sti* 

254 jiystcmCj チャイ _ ル！■•ブログラムの fe 故 

256 jnodu]evalue() 才ーパーレイモジ—ル.チャイル!••ブログラ 

ムからのの * W 
300 Jm«Du() フ7•イルの31択 

357 ,d>dir() カレントデ■(レクトりの変电 

358 ,getcwd() レントワーキングデイレクトりの S 得 

359 jnkdlr() ディレクトリの作成 

360 ^geUoginO ディスクの接嫌状況の抵得 

361 jiikfpatl>() 7ルパス名の强得 

362 «irst() »初のエント *> の検索 

363 _fnext2() 次のエン！•りの検索 

364 .dirname() パス名の解析（ディレクトりパス名の®得） 

365 basenameO パス名の解析（ファイル名の推得） 

366 ,fcreate2() 7 7■イルの析規作*(アトリビュート报定あり） 

367 lxios() MSX-D 翁 S2 システム3ー ルの戈行 (C 言斑対応） 

370 -fnew() 新しいエントリの検索 

371 .chkvcrsion() MSXView のパージ a ン番号の檢夜 

375 Ai*ve() 7 T イルの移 ill 

376 jRctattrO ファイルのアトリビュートの 5SW 

377 JgetattrO フ T イルのアトリビュートの設定 

378 Jgutftime() ファイルの日付と時刻の®得 

379 Jsettime() 7 T イルの日付と時刻の»定 

380 .fhdolete() 7 7•イルハン！••ルの削除 

381 .fhrename() フ7•イルハンドルの名 ffi の変 S 

382 .fhmoveO ファイルハン！••ルの栘助 

383 .Oigctattr() 7 r イルハンドルのアトりビュートの播得 

384 -fhsetattrO 7ァイルハンドルのアトリビュートの設定 

385 Jhgetftime() 77•イルハンドルの日付と時 S_l の抵得 

386 .fhsettime() 77■イルハンドルの日付と時期の坟定 


: irir 
~50T 



.executed) オーパーレイモジュールの变行（仔.索の77■イル） 523 

.cmkfpathO 7 7•イル作成用フルパス名の搀得 524 

_fpathset() 複数パスからの7 t イルの検索の S 定 525 

-fpothnextQ 後数パスからの 7 T イルの検索 526 

signal () 物理エラー&理ルーチンの设定 526 


ファンクシヨンの説明 


‘では、リ、 /— スマネージャの各フアンクシ3ンについて説明します。 



164 フアンクシ 3 ンの説明 


4$1 


16.4.1 表記法 

フ T ンクン3ンの说明では、次のよ7に表紀します， 


ファンクションの機能を示します 

@能番 


各フ r ンクシ*ンに別り角てられている番号です。 

各ファンクシ 3 ンを使用するの并式を示します。 


.dearwiniwin) 


[A] ゥ•(ンド… 


?|»の*昧 

の«け*しに使われる CPU レジスタ 
(アセンブラブログラ S ング時に使用） 

9IK« 

9IR の5! 


— の®味 

-戻り姐 

1 -«り*の屮き*しに使われる CPU レジスタ 

(7 •センブヲブ n グラム時に使用） 

そのフアンクシ B ンがどのような谢复をするかを示します • 

また、リソースマネ■ジャでは、7アンク〆ヨン実行時にエラーが発生 
すると、エラーの®®によってエラーダイア〇グの友示が異なります•そ 


• エラーダイ7•ログの表示は、以下のようになります。 

論理エラー時 a 示の有無の銳明 
物理エラー時表示の有無の說明 
という形式で説明します。 

論理エラーとは、 MSX-DOS2 の77■ンクン a ンコ ー ルが返すエラ'-で 
«2部 16.2 章 1 ■ファンク xa ンエラー J で説明されているものです • 

物理エラーとは、ディスクドライバが返すエラーで、第2部 16.1 章 1 ■ディ 
スクエラー j で说明5れているものです， 




リソースマネージャの初期化 


後能礬号丨 217 

し -S 式 j void .initres(void) 
[戻 Q 値 なし 


[解说： リソ—スマネ_ジャを初期化します-この 7r ンクシ3ンはシステムが 

自劻的に実行するので、アブリケー、〆ヨンから呼び出す必要はありません。 

• エラ_ダイアログの表示は、以下のようになります。 

淦理エラー•時エラーは発生しない 
物理エラ_時エラ-は発生しない 


デフオルトドライプの設定 



デフオルトドライブの獲得 

['梭能# < 219 

I 赛式 | TIMY . getdrive ( void ) 

[戾り値！ [A] デフオルトト•ライブ (O-A-.s 1-B:, -7-H:) 
[解！！1 "1 デフオルトドライブを iK しま1% 

• エラーダイア〇グの表示は、以下のようになります。 
論理エラー時エラーは％生しない 
物®エラー時エラーは充生しない 


ファイル情報の獲得 



ディスク情報の獲得 



16.4 フ 7 ■ンクシヨンの説明 


485 


ファイルの検索 


[梭能番泠I 222 


STATUS _fset(fn) 

char *fn [HL] ドライプ•パス•フ r イル ASCIIZ 文字列 


0 <1 | [A] 0K 7 7•イルが見つかった 

ERROR フ T イルが見つからなかった 


|解说| fn で夺えられたドライブ"、•ス•ファイル ASCIIZ 文字列でデ■(レクトり 

サ_チを行ないます • フ7■イル名には、7イルド々*-ド文字として r ?j を 
指定することができます C*j は指定•不可)。このファンクシ3ンでは、指 
定？れたフ7•イルが存在するかどうかを: _faext() のためにファイル名 
を S 定します。したがって、このファンクシ3ンだけを使用しても、： K 瞭の 
フ7■イル名を得ることはできません。この部分は、 _ffirstO や MSX-DOS2 
と»作興なるので、注*して下さい，実際にフ r イル名を«ベるために 
は、 Jnext() を使用します。 


エラーダイアログの表示 U， 以下のようにな9ます。 
綸 * エラー時表示なし 
物理エラー時表示あリ 



多のファイルの検索 



16.4 7 7 •ンクシ 3 ンの説， 


487 


ファイルのオープン 


['梭能#号1 224 

1卉式, HANDLE .fopenCfn, fh) 

- char *fn [HL] ドライブ•パス•フ T イル ASCIIZ 文字列 

HANDLE fh [E] ファイルハンドル 

[戻り） [A] ERROR 以外 7 7 •イルハンドル 
ERROR オーブン失敗 


f » a I ファイルをオーブンします • tt が〇のときに、輯しいハンドルを«り 

付けます。 fh に0以外の锿を指定すると、そのハンドルで7 7■イルオ—ブ 
ンを行ないますが.符に)!*由がない限り、0を入れて下さい。 


• エラ-ダイア a グの衣示は、以下のよつになります， 

綸现エラー時表示あり 
物理エラ-時表示あり 

[庄意| _fopen() をコ—ルしたときは、直後にそのハント•ルで，- chfile() また 

は- push«e() を実行しなければなりません。さもないと、他のファイルが 
壞れる可能性があります， 


ファイルのクローズ_ 


[機能番号 


225 


厂鲁式 I 


HANDLE Jclose(m) 

HANDLE fh [A] ファイルハンドル 


[SJ り 《 I 


U] OK クローズ成功 
ERROR クローズ失敗 


[ Of % フ7•イルをク〇_ズします。 

• エラーダイアログの表示は、以下のようにな9ます。 
»理エラー時+&示あり 
物理エラー時表示あり 
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ファイ ルの 新規成 _ _ 

[檐能番号丨226 

I 卉式 HANDLE .fcreate(fn, fh) 

1 -- char »fn [HL] ドライブ.パス•フ 7 •イル ASCIIZ 文字列 

HANDLE fh [E] ファイルハンドル 

[戾り ttJ [A] ERROR 以外ファイルハンドル 
ERROR 作成失敗 

[解说 i 新しぃファイルを作成します。 lh が0の場合に新い》ハンドルを K9 

付けますので、特に理曲のなぃ限り0を入れておぃて下さぃ， 

•エラーダイ T 〇グの表示は、以下のようになります。 

»理エラー時表示あ!） 

物理エラー時表示あり 

[注意丨 JcreateO をコールしたときは、 K 後にそのハンドルで -chfileO また 

は- pushfile() を实行しなければなりません，さもなぃと、他のファイルが 
壊れる可能 •&. があります- 


ファイルの削除 

機能番号] 227 


「嘗式1 


fdelete(fn) 

»fn [HL] ドライブ.パス.ファイル ASCIIZ 文字列 


[戻 1 )値] [A] OK OT 除成功 
ERROR 削除失敗 


[解说丨 fn で指定したファイルを削除します • 

•エラーダイアログの表示は、以下のようになります。 
論理エラー時衣示あり 
物理エラー時表示あ〇 



ファイル名•デイレクトリ名の変更 



戻り ft I 


228 


HANDLE ^renameCfnl fn2) 

char *fnl [HL] 変更;;£の卜•ライブ•パス•ファイル ASCIXZ 
文字列 

char *fn2 DDE] 変更後の名前へのポインタ 

[A] OK 成功 

ERROR 変 K 失敗 


• エラーダイ7■ログの表示は、以下のようになります。 
a 理エラー時表示あり 
物 a エラー時表示あり 


カレントファイルの 設定 



保存をともなうカレントファイルの変更 


[槪能 S 号] 230 

し方式 | STATUS . pusbfile ( fh ) 

HANDLE fh [A] フ T イルハンドル 


[戾リ妞 I [A] 0K 変更成功 
ERROR 変更失敗 

1解说I 現在のカレント77•イルをフ7■イルスタックに供み、新しいカレント 

7 r イルを fh て•播定したフ7■イルに«定します • fh が0のとき li、 7 T 
イルスタックに#(むだけで、カレントフ7•イルの® E は行いません，この 
フアンクン9ンを使うと， _p<^>fMeO を3—ルするだけでカレントフ r ■イル 
を元に戾すことができます，オーパーレイモジ：!•ールなどでフ7•イルを T 
クセスすると#は、この77■ンクシ S ンを使うと便利です。 


工•ラーダイアログの表示は、 JU 下のようになります。 
篇现エラ _n 孕 * 示なし 
物理エラ_時表示なし 


カレントファイルの復帰 



カレントファイルへの書き込み 


I檐能番号丨232 

L* unsigned _furite(buff , n) 

' TINY *buff [HL] バッファへのポインタ 

unsigned n [DE] .SS 込むパイト数 


[戻リ攸I 


[HL] 


0001H-FFFEH 

0000H 


実除に込んだバイト致 
ディスクフル 
物琛エラーが充生 


| W a | カレント 7r イル P buff からデータを n パイ！■苦き込みます，データ 

を*き込む位 a は， j««ek() で0出 ua 定することかできます. 


エラーダイア〇グの表示は、以下のようになります。 
論理エラー時表示あり 
物理エラー時表示あり 


カレントファイルからの読み込み 
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p イルポインタの設定 

[» 能番珍 I 235 


[ 再式 ] STATUS fseek(point) 

long *point [ HL ] ファイルポインタへのポインタ 


[戾リ^] [A] 0K 設定成功 

ERROR 設定失敗 


f » lii I 


カレントフ7•イルの77•イルボインタを汶定します。 - freadO 、 Jwrite () 
で i * み*きする位 S がフ7■イルポインタです。このフ T ンクン3ンを使え 
ば、7 T イル中の任,®の位 B に0¢み？ T きすることができます。 

• エラー ダイアログの表示は、以下■のようにな9ます。 

論琛エラー 時表示あり 


物*エラー時表示あり 


[it $ ； ファイルボイゾタは long ® で.ファイルポインタへのポインタをパラ 

メータとして® T ようになっています。 


ファイルポインタの獲得 


[機能#号 1 236 

| 吾式 | STATUS -fpoint(point) 

" ~ long *point [HL] 7 ァイルボインタへのポインタ 

[R ') to] CA] OK 換得成功 
ERROR 捶彳5失敗 


解说 ] カレントフ7•イルの 7 r イルボインタを point に返します。 


エラーダイアログの表示は、以 T のようになります。 
論理 エラー 時表示あり 
物理 エラー 時表示あり 
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ファイルサイズの獲得 

[« Sg * 237 

I 荇 _式] STATUS .fsize(length) 

long *length [HL] ファイルサイズへのポインタ 

I 庚り诚 | [A] OK 後得成功 

ERROR 後得失敗 

I解脱： カレントファイルのサイズを length に返します， 

• エラーダイアログの表示は、以下のようにな9ます。 

揄 理エ ラー 時表示あり 
物理 エラー 時衣示あり 

エラーコードの獲1 等 

[檐能#号] 238 
I 奔式] TINY •ferror(void) 

(_戾り値] [A] 直前のエラーコード 

[解扯 I K 前に起 S たエラーの種類を MSX-DOS2 のエラーコードで S します • 

MSX-DOS2 のエラー: J ー ドは' 2部16章 1 ■エラーおよびメッセ_ジ」を 
参照して下さい ■> 

• エラーダイア〇グの表示は、以下のようになります。 

論理エラ_時表示なし 
物理エラ_時表示なし 



MSX DOS 2 システムコールの実行_ 

み能番号| 239 

[ 墓式丨 void nsxdos(void) MSX-D0S2 システムコールの ilSS： 

[戻り fiSj MSX-D0S2 システムコールの戻り ffi 

广解説丨 アセンブラレペルで MSX..DOS2 のフアンクシ■ンコールを実行しま 

す。各々のフ r ンクン，ンコールに応じた値を、 CPU のレジスタに設定し 
てコールして下さい。 C 言語から MSX-DOS2 のフ7■ンクシヨンをコール 
するにI丈 -bd0B() を使ぃます， 

• エラ-ダイア〇グの表示は、以下のようにな9ます。 
a 理エラー時表示なし 
物理 エラー 時表示なし 


ファイルアロケータの初期化 



7 T« 域の 
:、 feeek(> 
戻り値が 


後で Jalloc() を 


論理セクタによる読み出し 


[楼能*号 243 


式 




drive [A] 
sector [DE] 
•buff [BC] 


sector, buff) 

!•* ライプ*号 （0=A:、1=B：. … 7，H:> 
論理セクタ sy- 

談み込み用パッフ r へのボインタ 


[« 0 ffi] tA] OK SEA 込み成功 

OK 以外迸み込み失敗 


解说I 指定した!••ライブ番号.»現セクタ番号のデータをディスクから a み込 

みます。 


エラーダイアログの表示は、以下のようになります • 
綸理エラー時表示なし 
物理エラー時表示なし 


デイスクフオーマツトメッセージの獲得 



ディスクのフォーマット 


1^1能番号I 






*buff»r CHL] 

drive/type [DE] 

CD] ドライブ*兮(0-*:. 1=B:, -7-H:) 

[E] タイプ 
bufflen [BC] 


[*] OK 7 ォ■•マット®功 
ERROR フォーマット失敗 


« 觇I ディスクをフォーマットします。 

• エラー ダイアログの表示は、以下のようになります。 
篇理エラ-時表示あり 
物墁 エラー 時表示あ！） 


カレントファイルの獲得 



才ーバーレイマネージャの初期化 

「梭能 S *>1 248 





オーバーレイモジュールの実行 



MSXView アプリケーションの起動 


[機能番号] 252 


STATUS .jump(fn, paraal, param2) 

char *fn [HL] ドライブ.パス ■ 7 7 ■イル ASCHZ 文字列 

char *paraml [DE] パラメータ 1 

int aram2 [BC] ラメータ 2 


[戻り ffi I [A] OK 起财成功 

ERROR 起觔失敗 

[» si ] 指定したブログラムを起魴し、制御を移します。呼び m されたプ〇ダラ 

ムの‘美行が終了しても、呼び出しにはもってきません，そのモジュール 
が終了すると、 VSHELL または現墳変歎 VIEWVSHELL で設定されたブ 
d グラムが起抑されます， 


エラーダイアログの表示は JTF のようになります • 
»理エラー時衣示あり 
物理エラー時表示あり 


オーバーレイモジュール • 子プログラムの強制終了 



子プログラムの起動 
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オーバーレイモジュール•子プログラムからの戻り値 
の獲得 _ 

[檐能番号 J 256 

I 害 玖 ] unsigned jsodulevalue (void) 

[mow] [hl] wm 

[觯说. オーパーレイモジュール•子ブ〇グラムからの戻り倣を 3S 得します。 

..execute() や _system() の戻0值は、モジ：！■-ル•ブログラムが起動された 
かどうかなので、才 一•»< •■レイモジュール•子ブログラムからの戻り値を 
調べるためには、このフ t ンクン a ンを使用します- 

• エラーダイアログの表示は、以下のようになります。 

綸理エラ-時エラ— li 発生しない 
物®エラー時エラーは発生しない 



フアイルの選択 


[機能 S 号 '1 

CXXj 
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•wild [HL] パスを含むワイルドカード 

*pn CDE] フルパスファイル名へのポインタ 

*ev [BC] イペン！■へのポインタ 


[庚り ffi I [A] TRUE 进択された 

FALSE 遘択されなかった 


[W % ' wild で报定されたワイルドカー！••に当てはまるファイル名を， ev で示 

される場所にボップアップ形式で表示します。そして，ユーザーの選択を 
待ち、どのフ7■イルが；!!択されたかを、 pn で示される埸所に返します， 
wUd は、 」nk 年 ath() から®された，バスを含むワイルド々 一I ••を«しま 
す。 pn は.进択？れたファイル名を格納するのに充分な ft さ （64 バイト 
以上> の領域へのポインタを*します。抑は、このフ7•ンクシ a ンが呼ば 
れる原因となったイベントへのポインタを®します。 

通常は 

if (_f menu( jnkf pathCCATJIN, "????????.)??"), 
fils, ftevent) = TRUE) 

-juHp(file, paraol, param2) : 


のように寞行フ T イルの*択に使用します， 
version 1.20以降では、 wild には -mkfpath() が ife す、以下の形式の文 
字列を与■えます， 


< r ；J で区切られたパス*ぴ ><00H><7 7 ■イル名 ><00H> 


エラーダイアログの表示は、以ドのようになります- 
綸《エラー時表示あ 1 ) 

物理エラー時表示あ9 



カレントディレ之トリ C 0 変更 


_梭能番号 


357 


STATUS .chdir(dir) 

char *dir [HL] ドライプ • パス•ファイル ASCIIZ 文字列 


[戻り ffi 1 [A] OK 变£成功 

ERROR 変史失敗 


[解说」 カレントディレクトリを dir で梢定したデイレクトリに変 K します。 


エラー ダイ TD グの表示は、以下のようになります。 
»理エラー 時表示あり 
物エラ_時表示あり 


カレントワーキングディレクトリの獲得 



ディレクトリの作成 




STATUS jnkdir(newdir) 

char *ne»dir [HI.] ドライブ*バス•ファイル ASCIIZ 文字列 


[戻り te」 [A] OK 作成成功 

ERROR 作成失敗 

[ « k 1 newdir で衍定した名前のディレクトリを作成します。 

• エラ_ダイア〇グの表示は、以下のようになります。 
掄理.エラ_時表示あ！） 

物理エラー時表示あり 


ディスクの接続状況の獲得 
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フルパス名の 獲得 

丨播能# 〇 361 

[ 其式 char *jnkfpath(cat, fn) 

一一 int cat CHL ] カテゴリ*矽 

char *fn [DE] フ 7 •イル名へのポインタ 

I 戻リ値丨 CHL] 卜•ライプ■パス.ファイル* SCIIZ 文字«へのポインタ 

[ 髀说 ] 田境変数の数:定に応じた7ルパX名を梅得します。 cat に現境変数名に 

対応したカチゴリ番号を、 fn にパスに接校されるファイル名を揹定します • 
7ルパス名の実体は、 MSXView 勿ーネルのワークエリアにあり，他の用 
途と共坩しています。したがって、 jnkfjxith の呼び出し直後に _fopen() 
Jcraate/), jump(). -fmenu()、-fi>athset() および <sy8tein() を呼ぴ出 
す場公に限り、 jnkij^O の戾リ械をそのまま故せます。しかしそれ以 
外のときは、アプリケー〆 a ンの*?-クエリアなどにコビーしてから便用 
して下さい。 

々テゴリと斑境変我の対佑 

カチゴリ名 環«变«名 
CAT.TOP VIEW 
CAT3IN VIEWBIN 
CATJJA VIEWDA 
CAT-OVL VIEWOVL 
CATJONT VIEWFONT 
CAT_PD VIEWPD 
CAT-TEMP TEMP 
CAT-HOME HOME 
CAT-CLIP CLIP 
version1.2 で追加されたもの 
CATJ)ATA VIEWDATA 

CAT-PATH PATH _ 

環境変数が未定典の場合. CAT-TOP、CAT.TEMP, CATJiOME は「 
A:j になります。 CAT-BIN, CAT-DA, CAT-OVL、CATJONT, CAT_PD 
については、 CATJTOP を思！ベて、 CAT-TOP が未定義ならば r A:j にな 
ります • 定義されていれば、 CAT-TOP の T のそれぞれ BIN, DA, OVL 
PONT、PD となリます。 CATCLIP は CATJIOME と同じになります • 
CATJJATA は CAT-TOP と H じにな 1 )ます。 
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この7ァンク y 3ンは version 1.20 以降とその他で勒作が異なります。 
version1.0 および U では、々テゴリ*号に相当するディレクトリ名 
に、指定されたファイル名が連結されるだけです。 

version 1.20 以降では.々テゴリ番号に相 S する環境変数に，複数のパ 
スをセミコ d ン r ;j で区切って紀述できるようになりました，そのため， 
フ7•イル名にワイルドカードが含まれない場会は、楔 K のパスの中から紀 
述された順に指定されたフ7•イルを探し、最初に見っかったファイルの名 
前をフルパス名で返します。フ T イルを探しているときに、そのパスのデイ 
スクドライプにフロッピーディスタが人っていないと、エラーは表示され 
ずに、そのディスクには見つからなかったものとして，次のパスを探しま 
す。環境*数に記述されたすベてのパスを探しても兒つからなかったとき 
は、 SCit されたパスの最初のパスにファイル名を®結して、その7ルパス 

名を返します。7イルドカードが含まれる場合は，その5!境変数の ffi その 
ものに 7T イル名を NUL キャラクタをはさんで®結したものを返します。 
っまり 

<«境変数の値 （ r ;j で区切られたハ•ス並び） ><00H>< ファイ 
ル名 ><00H> 

が返されます • この戾り値はそのまま _6nenu() や Jpathaet() に液すこと 
ができます。 


エラーダイア〇グ表示の有無 
versi'cai1.0 および 1.1 の場合 
綸理エラーエラーは筅生しない 
物理エラーエラーは筅生しない 
version 1.20 以 W の場合 
綸理エラーエラーは発生しない 
物理エラー表示 A り (drive notready を除く） 
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最初のエントリの検索 

[棰 * 号1362 


*pfib [ HL ] ドライプ，パス • 7 t イル ASCIIZ 文字列 
または FIB ポインタ 
*fn [ DE ] 検索するフ T イル名 

•fib [ BC ] 検索結果を返す FIB へのポインタ 

attr [A ■] 検索するフ7•イルの性 


[戻 1 ) ft I [ A ] MSX - D 0 S 2 のエラーコード 


[解说丨 77■イル.ディレクトリの検索をします。 

pfib に、検索するフ7•イル•ディレクトリ（<7イルド/ドを含む）も 
しくは FIB へのポインタを指定します。 

fa には， pfib が FIB へのポインタの場合•のみ、フ7•イル名へのポインタ 
をネ旨定します。 pfib がファイル名へのポインタのと S は、 NULL を指定し 
て下さい • 

fib には、検索が入る F 1 B へのポインタを播定します。 attr には，検 
索するファイル*ディレクトリの*性を IS 定します。 

SOte は MSX - DOS 2 のエラーコードと间じです。 Jset () と逸い、 _ ffirst () 
は fck 初のファイルを返すので注*して下さい。この7ァンクシ a ンは、 Jset (). 
Jnext () とはまったく別なので、混同して使うことはできません。 

ファイル®性の®味については、 *2 部 r MSX - D 0 S 2 j の77■イル情報 
ブロック ( P .22 B ) を麥照して下さい。 


x ラーダイア〇グの*示は、以下のようになります • 
論理エラ_時表示なし 
物理エラー時表示あり 



次のエントリの検索 



パス名の解析 (ディレクトリパス名の獲得 ) 

[嫌能*号] 364 

[害式] STATUS dirname (??<?, Set ) 

char CHL ] ドライプ•••ぐ X •ファイル ASC 



パス名の解析（ファイル名の獲得） 


[« *6 # ^] 365 




tra-l ドライブ•パス.ファイル asciiz 文字列’ 
*dSt^ [DE] フ7•イル名を返す領域へのポインタ ^ 



ファイルの新規作成（属性指定あり） 




MSX - DOS 2 ファンク シヨ ンの 実行 （ C 言語対応） 
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新 U 、 エントリの検索 




厂 盡式1 


STATUS JneuCfiij attr, template) 

char »fn [HL] ドライプパス • 7 7 •イル ASCIIZ 文字列 

TINY attr [E] フ r イル® 性 

FIB *template [BC] 


「K リ姐： [A] MSX-D0S2 のエラーコード 

[解说 j 新しいファイル•ディレクトリを検索します。 fn に検索するファイル 

またはデイレクトり（ワイルド勿ードを含む）を、 attr に携索するフ7■イ 
ル•デイレクト IJ の ffiffi を指定します， template に検索結果が返ります。 
fn および attr で播定したファイル•デイレクトリが1つでもあればその検 
索結果が、1つもなければファイル•ディレクトリが作成され，その結果 
が返 1 )ます. 

烊しくは、»2部 r MSX DOS2j の新しいエント U の検索 <P.293> を 
#照して下5い。 


エラーダイアログの表示は、以下のようになります。 
綸理エラー時表示なし 
物理エラー時表示あり 



16 4 フ T ンクシ 3 ンの说明 


S1S 


MSXView のバージョン番号の検査 

[ffl fig S 5-J 371 


,[a ] 


STATUS .chkversion(version) 

unsigned version [HL] 検 ft するパージ 3 ン番号 


「現り値1 [A] 0K 適合 

ERROR イ、•迪介 

[HL] MSXView のパージョン番号+1 



[w a 1 指定したパージ3ン»号以上の Msxview であるかどうかを検 a し 

パ—•ン3ン番号+1を返します。 

MSX Viewversion 1 .00 では 0x101 を返します， 


エラーダイアログの表示は、以下のようになります • 
綸理エラー時エラーは死也しない 
物理エラエラーは 発生しない 


ファイル • サブデイレクト りの移動 

[檐能番号丨375 


厂古式1 


STATUS fmoveCsrc, dot) 

char »src [HI] ファイル名またはサブデ■(レクトリへのポインタ 
char *dst [DE] 移®)先のパス♦フ7•イル名 


r K ') (A 1 [A] 0K 移 功 

ERROR 移 W 失敗 


[解説 I src で指定された 7T イルまたはサブディレクトリを、 dst に S 定した 

パスに移動します。 src には移©するパス* 77•イル名を、 dst には移動先 
のパス.フ7■イル名を指定します， 

詳しくは、第2邮 「MSX-DOS2j のファイル • サブディレクトりの移®！ 
(P.203) を奉照して下$い， 


エラーダイアログの表示は、以下のようになります。 
途理エラー時衣示あり 
物理エラー時表示あり 
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ファイル属性の獲得 


[_ 機能番号I 

匕#式」 


376 

STATUS Jgetattr(fn, attr) 

char *fn [HL] ドライプ.パス.フ 7 ■イル ASCIIZ 文字列 
TINY »attr CDE] 属性へのポインタ 


戻り値] [A] 0K 播》成功 
ERROR 橄得失敗 


» 说1 fa で衍定されたフ7■イルの«性を attr に返します。 

洋しくは，35 2® r MSX-DOS2j のファイル®件.の後得•セ y 卜 （P.307〉 
を参照して下5い。 


エラーダイア〇グの表示は、以下のようになります。 
綸理エ ラー 時农示あり 
物现 エラー 時表示あ t) 


ファイル属性の設定 

@能#号丨377 

I 3=式 | 




fsetattr(fn , attr) 

ドライブ•パス•ファイル ASCIIZ 文字列 
ファイル R 性 


解 


説 


fn で指定されたフアイ■に、 atlr で衍定した K 性を段定します。 
詳しくは、第挪 r MSX » BOS2j のフ T イル (* 性の®得セ；/卜 (P.307) 
を参照して下さい， 


エラーダイアログの表示は、以下のようにな 1 )ます， 
綸 Jf エラー時表示あ!） 

物理エラー時表示あり 



ファイルの日付と時刻の獲得 



ファイルの日付と時刻の設定 


[棰能番号1 
I g 式 I 

[戻 1 ) ttj 




STATUS .fset'time(fn 1 date, time) 

char *la »JL] ドライブ*八ス.ファイル ASCIIZ 文字列 

int date [DE] セットする日付の値 

int time [BC] セットする時刻の値 

[A] 0K 玟定成功 
ERROR 没定失敗 


解！)I1 fo で播定5れたファイルに date と time で指定された日付と時刻をセッ 
I•しま1% 

詳しくは、第2部 「MSX-DOS2J の77•イルの日付および時刻の®得 
セット (P.308) を参照して下3い， 

• エラーダイアログの表示は、以下のようになります， 

»琿エラー時表示あ!） 

物理エラー時表示あ!） 


ファイルハンドルの削除 



ファイルハンドルの名前の変更 


[* fig # 381 


T 




HANDLE 


[A] ファイルハンドル 
*nevname [DE] 変更する名前へのポインタ 


[戻り庙丨 [A] 0K 変更成功 

ERROR 変®失敗 


解说 ] ハンドルで指定されたフ7■イルの名荊を、 newname で示される ASCIIZ 

文字列の *05 に変 K します。 


エラ—ダイアログの表示は、以下のようになります。 
»理エラー時表示あり 
物理エラー時我示あり 


ファイルハンドルの移動 


.機能番号| 382 


1卉式 | STATUS fbmoveCfh, dst) 

HANDLE fh [A] ファイルハンドル 
char *dat [DE] 移觔先パス名へのポインタ 


[H ') ffi] [A] OK 移動成功 

ERROR 移動失敗 


[W IK I ハンドルて•报定されたファイルを dst に設定したパスに移®します。 

■ エラーダイアログの表示は、以下のようになります。 

論理エラー時表示あり 
物理エラ-^ 表示あ 1 ) 



ファゴ生ハン ドルの属 性の獲得 

[槻能袷5 | 383 


匕臺式」 


STATUS jfhgetattr(fh, attr) 

HANDLE fb [A] 77 •イルハンドル 

TIDY »attr [DE] 属性へのポインタ 


[« 'J ffi] [A] OK 梅得 IS 功 

ERROR 琅得失敗 


〔 W 说 I ハンドルで憤定されたフ r イルの » 性を attr に返します。 

•エラーダイア〇グの表示は、以 T のようになります。 
綸埋エラー時衣示あり 
物理エラー時表示あり 


ファイ ルハン ドルの属性の設定 
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ファイルハンドルの 日付と時刻の獲得 


[[機能#号-] 385 


STATUS _fhgetftime(hd, date, time) 
HANDLE hd CA] ファイルハント*ル 

int *date COE][1 付へのポインタ 

int *time [BC] 時刻へのポインタ 


f 保り攸丨 [A] OK 埵份成功 

ERROR 播得失敗 


f 解说丨 ハンドルで播定されたフ7■イルの B 付と時刻を、それぞれ. date と time 

に&します。 

•エラーダイアロ グの 以下のようになります。 

3ft 理エラー時我示あり 
物理エラー時表示あり 


ファイルハン ドルの日付と時刻の設定 


[« H& * 


号| 




厂赛式1 


STATUS .fbsettimeChd, date, time) 
HANDLE hd [A] フ 7 ■イルハンドル 

int date CDE] セツトする 0 付の値 

int time [BC] セットする時ん)の値 


0 [A] OK 攻定成功 

ERROR »定失敗 


解 说 ] hd で析定された 7T イルに、 date と time で报定した B 付と時刻を》 

定します。 


エラーダイアログの表は、以下のようになります。 
論: (1 エラー時表示あり 
物埋エラー時表示あり 




エラーダイ To グの表示は、以下のようになります。 
諭 J8 エラー時表示あり 
物理エラ_時表示あリ 



オーバーレイモジュールの実行（任意のファイル） 



ファイル作成用フルパス名の獲得 
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複数パスからのファイルの検索の設定 


[棣能番号丨 


char *wild [HL] パスを含む 1 7 イルドカ—！ •• 


[m <) ffij なし 

(_ » w | »a のパ x から、 a 合するマ？■イルを探すための袍数パスおよび 1 7イルド 

»— ドを®むファイル名を设定します，この7アンクシ3ンは， Jpathnext() 
と#4にして使います。 _faext() や _feext2() と混同して使うことはできま 
せん， 


wild には jnkfpathQ が VS す 


< r ；J て•区切られた*^ス兹ぴ ><OOH>< ファイル名 ><00H> 


という®式で複数パスおよぴフ7•イル名を指定します • 

この7アンク-〆3ンは version 1.20 以降で使用できます。 


エラーダイアログの表示は、以下のようになります。 
綸理エラー時エラーは発生しない 
物理エラー時エラーは発生しない 



複数パスからのファイルの検索 


[機能番号丨415 


^ ^ 1 


STATUS .fpatbnextCpn, nthdir, fnp) 

char *pn フルパス¢5 

TINY *nthdir デイレクトりの変更回数 

char »*(np ファイル名ハ、のボインタ 


CA] 


MSX-D0S2 のエラーコード 


[M % I Jpathset() で欲:定された複»のパスから、迪合するファイルを探しま 

す。 _feet()、JhextO と同じように， _fpathnextO が呼ばれるたびに通合す 
るファイル名を返します。 pn で示される領域に、兄つかったフ7■イルのフ 
ルパス名が返されます《 fnp で示される領域に、見つかったファイル名へ 
の,ボインタが返されますが、 fap が NULL であったら®されません。探し 
ている間に、次のパスに移った場合は、 nthdir で示される ffi が+1されま 
すが、 nthdir が NULL であったら行なわれません， 

このフ7•ンクシ，ンは、 .fpathset() と対にして使います。 _fcet() や- ffirst() 
と混同して使うことはできません. 

このフアンクシ a ンは version 120以降で使用できま 


エラーダイアログの表示は，以下のようになります。 
諭理•エラー時表示なし 
物理エラー時表示あり 


物理エラー処理ルーチンの設定 



16.4 7 7 •ンクシ 3 ンの説明 


択さ扎その選択が MSX-D0S2 に返されます。 _signal() を使用すると， 
物理エラーが充生したときにアブリケーションを呼び出すように;^定する 
ことができます。 -signalf) を呼び出十と、以前設定されていたエラー処理 
ルーチンの T ドレスを返します • 

物理エラーの種類によって3つの) a 理ルーチンを別々に設定できます， 
1っは 1 ■塞•き込み禁止 J、 もう1つは•■ディスクが入っていない J、 そして， 
その他の物《エラーです。どのエラー*1理を a 定するかが sig です. 

SIR には以下の値を议5：します- 

飞前 種類 一 

SIGPHYERR 1 他の物理エラー 

SIGWRPRTCT 2 番き込み货 it 

S1GNRDY 3 ディスクが人っていない 

物理エラーが充生したときは、まず「窨$込み禁止 j であるかどうかが 
期べられます。次に、•■ディスクが人っていない j であるかどうかが調べら 
れます • どちらでもない場合は、 1 ■他の物理エラー j とされます， 

func はエラー*1理ルーチンのアドレスです • func に SIGJDFL という 
«を入れて*すとデフォルトの舫作、っ4り物理エラ*-発生時にエラ—ダ 
イアログが表示されるようになります。 SIGJGN という値を人れて推す 
と、物環エラー発生時に11常にアボートのとな9、エラーダイアログ 
は表示されません。また、エラー旬:理ルーチンも呼ばれません， 

SIG.DFL と SIGJGN の具体的な値は以下の通 1 )です • 

名® 値 
SIG.DFL 0 
SIGJGN OFFFFH 

MSXView が起勒された時点で li« 述のとお*)、 SIG-DFL が»定され 
ています《 

なおアブリケーシ3ンが._8181»1〇を使用したときは、アプリケーション 
の終了時点で SIG.JJFL になっていなければなりません， 

エラー fc 理ルーチンの呼ばれ方 

エラー* i 理ルーチンは以下の两数で受けるようにします。また、エラー 

理ル--チンからそのままアブリケーシ s ンの feU を絞行•してはな！）ませ 
ん。つま0、必ずリターンしなければならないということです， 
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TINY fuiic(errcode, drive) 

TINY errcode [A] x ラーコード 
TINY drive [E] ドライブ番号 

errcode はエラ-•コードで， MSXDOS2 のディスクエラー:ドと同じ 
です • 具体的な ffi は、第2»16.1 1 ■ディスクエラ _j を#照して TF さい， 
drive は [E] レジスタにドライブ S 号 (0=A:. 1=B、 … 7=H:) がセ y 
卜5れます。 

funcO は、以下のどちらかを IA] で返さなければなリません • 


ffi 息味 

〇 再玄行 "t る 

1 アボートする 


この7アンクシ*ンは、 MSXView version1.2 以降で使うことができ 
ます。 


エラーダイアログの ft 示は、 aT のようにな 1 )ます。 
綸理エラー時エラー発生しない 
物理エラー時エラーは発生しない 



i7 章 

イベントマネージャ 


この章では、イベントマネージャの棋成や各ファンクシ3ンについて说明します。 

17.1 イベントマネージャとは 

イペントマネージャIねシステムに対する外部からの入力を味一的に*理するマネージャ 
です。例えば、ポインティングデパイスの助きに合わせて、力ーソルを画面上で移»させる 
tt： 理 A イベントマネージャが管璦しています • 

MSXView で《、別り込み、ボインティングデパイス、キーボードが外部入力です。 

17.2 イベントマネージャの使い方 

ほとんどのアブリケー-〆 s ンはイベントを*得して動作するので、メインループは、 _getevent() 
を操り返し呼ぶことになります。名 etevent() で得たイペント悄«に基づき、 switch case 文 
で分岐して、各々の*4理を行います， 

17.3 イベントマネージャの構成と機能 

以下では、イベントマネージャの構®と«能について31明します。 

17.3.1 イベントの種類 

イベントには、次のようなものがあ 1 )ます。 

•トリガダウンイベント (TRIGDN) 

ボインティングデパイスの 1st ボタンが押されたときに発生します。 

• トリガアップイベント (TRIGUP) 

ボインティングデパイスの 1st ポタンが離されたときに#！生します。 


アボートダウンイベント （ABORT) 

ボインテイングデバイスの 2nd ボタンが押されたときに発生します。 
アボ ー I■アップイベント (ABORTUP) 

ボインテイングデパイスの 2nd ボタンが離されたときに発生します。 
キーボー ドイベント （KEYEVT) 

キーボ_ドが押されたときに充生します • 


注 fi ' マウスの勳き（力ーソルの抑き）は- geteventO では知ることはできま 

せん，しかし、 _gctcoord() というルーチンで，ポインティングデバイスの 
M きを t 视することはできます， 


17.3.2 イベントレコード 

イベント悄相は、それに两するすべての"的杻を含むイベントレコードによって知ることが 
できます，イベントレコードは以下のように定*されています。 


typedef 




TINY 

TINY 


EVENT; 


msg[4]; 


イベントの秘類 •/ 

/* ポインティングデバイスの位 ffi */ 
/* ポタンの状® •/ 

/* キーコード*/ 

/• キーの状» •/ 

/• キーマップ •/ 

/• A ツセージ拿/ 


名前 サイズ 意味 

kind 1バイト イベントの ftHi 

kind にはイベントの種«を*別するイベント*号が入っていま 
す。槱準イベント番•はとして，以下のように定衣されて 
います- 


•define KEYEVT 1 
•define GDN 2 
#datine GOP 3 
•define RT 4 
fdefine RTUP 5 


/• キーが押された*/ 

/*1st ボタンが押された*/ 
/•1st ボタンが離された*/ 
/* 2nd ボタンが押された*/ 
/• 2nd ボタンが離された*/ 
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ポインティングデパイスの位 K 

where にはイベントが発生したときの、ポインティングデバイ 
スの座が入っています。座標はグローバル（幽面上の絶対> 座 
«です》 

WORD xp; /» X座揉*/ 

WORD yp; /• Y 座揉 •/ 


ボタンの状態 

bstal には、イベントが発生したときのポインテイングデバイス 
のボタンや ISHIFTI キーなどの状態が入っています。それらの 
状想は押されているかいないかが、ビットで表祝されます。ビッ 
卜が立っていたら、押されていることを表します。 

ビットの荆9当ては以下のとおりです， 
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[[注 M I ISELECTl キーと IST6PI キーとは、ポインティングデバイスの1st、 

2nd ボタンに剌〇振られるので，特殊キーコードとして得ることはできま 
せん》 


15 - ,, 

K 棚 0 | キト . ！，る。 

1 Jf* 1 h5i=f 2 = = E_E=„ii 

1 r,Lpt 一 ^,cs 1 OME 

減 1 卜 | 画ビ 76543210 キー ESTABSvINDEHOt TIF1F2F3F4F5 
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サイズ 

S 味 

key map 

1 パイト 

キーマップ 

kind がキーボードイペントのとき、 kcymap にはそのとき柙され 
たキーのハ--ド的なキー*号が人ります。 kind がキーボードイ 
ベントでないときは0が人ります。表3.17を参照して下さい。 

msg 

4パイト 

メツセージ 

アブリケ—ジョンが自由に使用してよいエリアです。 


& 3.17 キーマトリックX 


キー S 号 (16Jt) 


30 SHIFT CTRL GRAPH CAPS 冷ナ 

38 P4 PS ESC TAB STOP 


40 , SPACE HOME 


SELECT RETURN 




17.3.3 キーボード配列 

イベントマネージャは，キーボードがかなロックされているときに、其除のキーボードの 
K 列がどうなっていても，仮想的にキーボード配列を»定することができます。 

キーボードの状想を表す«造体は以下のように定箱されています， 

TINY config; ✓•キーボード fid 列*/ 

TIMY kana; /* かな ロック*/ 

TIMY caps; /» CAPS ロック*/ 
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表 3.18 LOCKS 構造体の内容 


名的 m 

conflg キー ボー ド fid 列 

0 口ーマ字嗣 
1 JISK 列 
2五十音 K 列 
kana かな n ック 

0 かなロックされていない 

0以外かなロックされている 
caps CAPS ロック 

0 CAPS ロックされていない 

0U 外かなロックされている 


以下で.各配列について 说明 します。 

口ーマ字 B 己列 

D- マ字 fl 己列は、 QWERTY K 列と同匕です • ローマ字かな変換した情報がイベントにな 
るわけではなく、 QWERTYK 列と间匕イベントが返9ます。 

文字を入力するときは、テキストマネ_ジャが*見在のキーポード K 列を参照して、〇—マ 
宇8£列だったら n —マ字かな変換を行います。この热理は、かな漢字変換の 一a として扱わ 
れます。 

JIS 配列 

かな入力時に、キードを JISK 列にします。 

五十音配列 

かな人力時に、キーボードを 3L 十®配列にします。 

17.3.4 ポインティングデパイス 

ボインテイングデパイスのサボート方法は、 MSXView vereion 1.20以降とそれ以前では 
51な9ます。 

1.20 未•滿では、デ/«イスとしてキーボードとマウスに対応し，システム設定 DA で設定さ 
れたポインティングデパイスに応じた処理を行ないます。 
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1.20 以降では、ポインチィングデバイスとしてジョイスティックに対応し、 MSXView 
自身かデパイスを0勉判別して処理を行ないます • した:^つて _sctdeviceO、 名 etdevice{) を 
W® 的に他用する«味はありません。 


17.3.5 カーソル 

MSXView には，ポインテイングカーソルおよびウィンカという2種類の力—ソルがあり 
ます。ここでは，それぞれの力ーソルについて説明します。 

ボインティングカ_ソル 

ポインティング*-•ソルとはいわゆるマウスカーゾルのことで、ボインテイングデパイス 
の動きに合わせて移#)する力ーソルとして、函面上に1つだけ表示3れます。 


& 3.19 ボインテイングカーソルの内容 


名前 

力_ソル形状 


義 

ソルの形状は、 16x16 ドット U 内の大き5なら、どのよう 
な形状にすることもできます。色は2色（透明を人れて3色） 
で、座 mm との; ft 理演 at 可能です。 

カーソルバターンのテンプレート 




TINY 

TIMY 

COLOR 

CURSOR; 



coll; 
pat 1 【32]; 
col2; 
pat2[32]; 


/* ホットスポット 


•/ 


o y マク •/ 
/* カラー */ 
/* バタ—ン l*〆 
/* カラー •/ 
/* バターン2 •/ 


カーソルの形状 (i 12個までで、それぞれ tl~12 の番号を荆リ 
当てています。形状#号1、2は®準力ーソルバタ•ンに別9当 
てられ、3以 •!*. はアプリケーシ3ンが定*します。 

番■号名® 棰 fig 

1 システムカーソルシステム樣準の矢印カーソル 

It 

2 ジ 3 ブカーソル 砂時針の形をしたカーソル 

^ ディスクアクセスなど、％理{こ時 

厢がかかるときに表示します， 




クインカ 

ウィンカとは、カーソルキー <0(X)0(3> に追従する、明滅するカーソルのこと 
です, ウインカは、画面上に1つだけ*示されます。ウィンカは、テキストマネージャなど 


ン。ソでぼテ 
ィす一が№1ス 
ボま力と 16 シ 
■せにこ i 、 

でさ域る n ( は 
212212212212班旧ぱ以範」1 
- みをれにす番 

込ルさ的 ftl 卜 

一 E,:;S_H 

ャてば113 £L ン 

:: : 13 ; 


IrHly— !11 

' J - UU - 卜： sig 力，ル-7-ぱ 1 6£ル咄 0 麻 rlt ; h.rla : 


11:; 
rdord siz e 
§ sal-s 

3 rrl 

x vro 11 

.axpypxsys 

LS- 

stilltint 咖刪 ARE 


-; 


卜き定カルで 
ベのをけ’ I s 


~ 示 p 
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ウィンカの存在を51にする必踅はありません • ただし、 •snscvcntO を使用して.リアルタイ 
ム処柙を含むイベント待ちを行っているときは. -chwink ⑼でウ •< ンカを消さなければな*) 
ません0 


衣 32(1 ウイン*の内容 


名前 

意味 

ウインカの位 K と大 
きさの指定 

ウィンカの位; St 人きさの指定は， jieaiowinlwrO で tr います • 
形状は四角形のみです。 

ウィンカ情银 


HANDI.E win; /* ウイン！•‘ウ ID •/ 

ARE* area; /* ウィンカの位茜と大きさ*/ 

int 8 peed; /* ウインクスビ _ ド*/ 

TINY rev! /» リバー ス 3— ド*/ 

> WINK; 

ウインクスビ_卜" 

**1 と«との明隔を等しくしたいときは， 51*0 x 1 の tr -ノ トで ffi* 
します。ビット 0 を立てると、ウィンクしません。それぞれの 
ビットを 1 つだけ立てると、 a 当するスビードでウィンクしま 
す。複数のビ V 卜を立てると、叫の時問がなくなります， 

ビットスビ_ド 

〇 ウィンクなし 

I 速い 


15 2¢ ぃ 


明滅の IfflW は.以下の7•ルゴリズムで行っています，したかっ 
て、 speed の*によって、ある程度叫滅の問隔を«節すること 
ができます。これをデ a •—ティの*®といいます。 


if ((JIFFTll)t speed) { 
disp(); 

> else { 

> era8S 

リバー ス a - ド 

ウィンカは、画面との XOR で表示されます。 rev はそのときに 
使用されるコードです。通常は OFEH を設定して下さい。 



17.4 キーボードイベントの内部処理 


イヘントマネージャは、割り込み中に HJCEYl 、 H . TIMI . 11-14£丫(：の3つの7，)>クから 
制御を奪います。以ドでそれぞれのフックについて规明します， 

17.4.1 カーソル表示 （ HJKEYI ) 

イベントマネージャは々—ソル移動時のちらつきをなくすため、 VDP の水乎ライン別り 
込みを使用します。水 f ライン割り込みは、毎回異なったラインに狡定されます。水平ライ 
ン剌り込みが発生したときは、 HJCEYI で W 抑を«い.々••ソルを*します，しかし，こ 
の別リ込みは、 RS*232C が使 ffl している可能性が商いので.-#先に元のフック先をコール 
してから热理を行います。 

17.4.2 ポインティングデパイスの読み込み （H TIMI ) 

この垂直鑼練袖*)込みでは、ポインティングデパイスの嫌み込みを行います。処理中は 
VDP に対して、すべての割り込み（垂 iffW 線、水平ライン> を輅止させます- 

17.4.3 キースキヤン ( H . KEYC ) 

MSX BIOS のキースキャンは使わず、 H _ KEYC で制御を奪い、キーをスキャンします。 
A レジスタに1を， HL レジスタに TABLE アドレスを入れてリターンすれば、 MSX は何 
もしません 


table : defb 0 

dbfv retret 

MSX View では、このデー_夕今べ*-ジ 3 に茜いています， 

このキースキャンは， (CAPSI キーとな丨キーだけを*！:理（ランプ）し、他のキーは 
fSHlFTL [GRAPH]. 1かな!^ (CTRL], L£AP§] キーの状®と一緒に.キ ー3 —ドをキーパッ 
フ T に入れるだけです。 ISELECTl キーと fSTOPI キーはボインチィングデパイスのボタン 
に対応するので、ここでは無視されます。 
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12 

13 

14 

15 
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19 

20 
21 
22 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 
43 


44 

45 



-putcvent() 

j>nscvent() 

-getcoord() 

_setkeyinfo() 

-getkejdnfo() 

_setdevice() 

^etpatcursor() 


,getpatnumber() 








_jobcursot() 
initwinkei() 

.deletcwinkerO 

.chwinker() 

.pusbwinker() 

.popvw*nker() 

_hide() 

-sync() 
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イベントマネージャの初期化 
イベント ffl 報の後得 

イベント情報のイペントキュ * の追加 
イベントの発生を調べる 
イベント情银をキューに庚す 
々ーソル座樣の播抒 
イベントキユーのクリア 
キーボ_ド状 a の a 定 
キーボード状態の搜得 
ポインティングデパイスの»定 
力-ソル表示の初期化 
ポインテイングデパイスの*得 
々ーソル八ターンの変更 
勿ーソルパターンの削除 
カレント；&ー ソルの播得 
力ーソルの有効領域の? EE 
力ーソルの有効エリアの削除 
ソルがあるエリァの®得 
システム々ーソ n< の设定 
ジ a プ勿ーソルの K 定 
ウィン*の初期化 
ウインカの作成 
ウィンカの削除 
カレントウインカの変更 
保存をともなうカレントウィン*の変更 
カレントウインカの祺« 

カレン!•ウィンカの抵得 
ウィンカ悄報の®得 
7> —ソルの表示 
カーソルの消去 
次の垂 ffi 同期までの待機 



ファンク シヨ ンの 機能を示します 


I 棣能番咢 I 

I g 式 I 


戾り値 I 


各フアンクシ a ンに別り内てられている番号です。 


各ファンクシ s ンを使用するときの式を示します。 


/ドウノ、ンドル 

I— 91»の立昧 

- i)|R の受け漉しに使われる _PU レジスタ 

(アセンブラプログラミンク特に使用） 

- 

- 91»の!！？ 


そのフアンクシ a ンの ft 作の結*.どのような鈑が返されるかを 
示します。 



イベントマネー;^ャの初期化 


[裱能番号]10 

| S 式 1 void initevent ( void ) 
[JK ') «l I なし 


解 m | イベントマネージャを初期 ft します。このフ 7 ■ンクシ 3 ンはシステム 

が fl 動に实行しますので，アブリケーシ 3 ンから呼び出す必要はありま 
せん。 


イベン ト情 報の獲得 

I 機能#号 I12 

| 丼式 | EVENT *_getevent (event) 

EVENT *event [HL] イベント格:造体へのポインタ 

り ®1 [HL ] イベント体へのポインタ 


[W SI 1 イベント悄報を event に返します。このファンクションは、イベントが 

発生するまで制御を R しません，アイドル状態のときに何か他の理（時 
刻の表示など〉をしたいときは •snsevent() を使って T さい。入カインジ 
ケ-夕の香き換えとウイン*のプリンクも、このフアンクシ 3 ンの中で行 
われます。 


イベント情報のイベントキューへの追加 



イベント琴李の調査 

〔梭能 S 号]14 


I @ 式 J BOOL .snsevent (void) 

り侦] [A] TRUE イベントが充牛-していた 

FALSE イベントが発生していなかった 

[W 说] イベントが発生したかどうかを M ます•人カインジケータの»き換え 

とウインカのブリンクも、この7アンクシ3ン中で行われます。 


イベント情報のイベントキューへの返還 

[棰能#号]15 

EVENT .event [HL] イベント構造体へのポインタ 


[戻り 1 なし 

[解说1 CV( ®t で指定したイベント悄報をイベントキューに戻します。 


カーソル 座標の獲得 



イベントキューのクリア 


1 棵能番兮 

17 

1 ® 式 1 

void .flushe»ent«(void) 

[_ 戾 9 ffi 1 

なし 

| 解说 | 

イベントキューをクリアします。 

キーボー ド状態の設定 

「機能番号1 

18 

1 杏式丨 

void ^etkeyinfo(lockstat) 


LOCKS *lockstat [HL] LOCKS 構造体へのポインタ 

| 戻锇 | 

なし 

« ^ | 

キーボード K 列.かなロック. CAPS 〇ックの状 B を a 定 L ます • 

キーボー ド状態の獲得 



ボインテイングデバイスの設定 


檐能礬号丨20 

1 S 式1 STATUS _aetdevlce(deT) 

L 一 -一 TINY dev [A] ，ボインテイングヂパイス揉 9 

[R り値1 U] ERROR 定かできなかった 


[解说I ボインテイン グデパイ Xを設定' _t す。 MSXView version 1.211以降で 

は、ボインテイ•グデバイスを自判別しているので，このフアンクシヨ 
ンをコールして，何もおきません。 


カーソル 表示の初期化 


[機能鼉号’ 21 




[R 0 ffi | なし 

解议」 システムカーソルとジ*ブ々•■ソルの杉状を a 定したあと，カーソル 

レベルを1に設定し、内部的に _systemcursor() を呼んでカーソルを衣示し 
ます。 


ポインティングデバイスの獲得 

1 梭能番号1 

22 

丨 S 式 I 

TIMY . getdevIce ( void ) 

I 戻*)値！ 

[A] ポインティングデノ<イスの 

MSXView version 1.20 以降では常に 1 

「 W itt | 

現在設定されているポインティングテ•バイスの棟類を返します • 
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カーソルパターンの 変更 

[後能# 5-1 25 

し洛 I 式」 HANDLE - setpatcuxsorCpat , cursor ) 

CURSOR *pat [ HL ] 冷—ソルパターンへのボインタ 

HANDLE cursor [ E ] 力*-ソルハンドル 

[R 0値] [ A ] 說定された力ーソルのハンドル 


[觯说 I cursor で指定したカーソルを pat で設定したパターンに変 E します。 

cw.vr に0を}8定したときは、供しいカーソルを；I定してハント•ルを返し 
ます。 


カーソルパターンの 削除 

[雄能籌璉_ 26 

| 齐式 | STATUS .killpatcursor(cursor) 

HANDLE cursor [AJ 々— ソルハンドル 

[興り値丨 C «] OK 削除成功 

ERROR 削眈失敗 

[ 解说丨 cursor で推定した 《 — ソルを削除します。 


カレントカー}/ルの獲!导 

1" 嫌能*号丨 27 

I 齐式 | HANDLE ^ecpatnunber (void) 

I 戻り Ml [A] * レントソルのハンドル 
[« 说 I 


現在表示されている力ーソルのハンドルを返します。 



* ーソルの5効領域の莩更 


28 

AREA *globalarea [HL] 析たに»定する 

HANDLE cursor [E] カーソルハンドル 

HANDLE curarea [C] エリアハンドル 


[A] エリアハンドル 

変 g に失敗したら ERROR 


cursor で指定したカーソルに対して> curnrca で衍定したXリアハンド 
ルの有効エリアを globalarea に突疋します。 cunrna が0のと§は，新し 
いハンドルを返します， 


カーソルの 有効 エリアの 削除 


I 檐能# $ 29 

| # 式'] STATUS Jcillareacursor(cursor) 

HANDLE cursor [A] 力ーソルハンドル 

[®5 >) ffl] CA] OK 削除成功 

ERROR 削除失敗 


» 说 I cursor で招定した々ーソルの有効エリアを削除します- 


匸 H ] 


カーソルがあるエリアの 獲得 



システムカーソルの設定 


1棰能#号1 

31 


HANDLE -systeacursor(void) 

[R <) ffl] 

[A] エリアハンドル 

「解 laT"! 

システムカーソル（欠印カーソル> の冇効エリアを_而仝体に; ai し 


て、エリアハンドルを S します • 

ジョブカーソルの 設定 

「橡能#り_1 

32 

1 方式1 

HANDLE .jobcursor(void) 

I k り ffl I 

[A] エリア/、ンドル 

解 n | 

ジ》プ*ーソル（砂時計力ーソル）を® is 全体に a 定 l て、エリアハン 


ドルを返します。 

ウィンカの 初期化 



ウインカの作成 


[楼能 S 号1 34 


S 


式] 


HANDLE .createwiDker(data , winker) 

WINK *data [HL] WXNKW?i6 体へのポインタ 
HANDLE uinker [E] ウイン々ハンドル 


[炅リ Wl [A] 作成されたウィン*のハンドル 

\_ w Si winker で指定したハンドルのウィンカを作成します。 winker が0のと 

きは、新しいハンドルを返します • data が NULL ボインタのと S は* メ 
モリ中に«造体の領域だけが劄り付けられ、ウィン*情報はすべて0で* 
められます。ウインハンドル Ui テキストマネ—ジャ用、ウイン”ハン 
ドル2はメニューマネージャ用なので、テキストを«坩するときは，壞さ 
ないで下さい. 


ウインカの削除 



カレントウインカの変更 

[tt fig # *>] :»6 


I 丧式1 STATUS .chuinker(uinker) 

' HANDLE winker [A] 新たにカレントとするウインカのハン！••ル 

「5£り依1 [A] 0K 変史成功 

ERROR 変 E 失敗 

W jft J カレントウインカを winker で指定したウインカに*®します • winker 
が0のときは.两两上にあるウインカを消去します • 


保存をともなう カレントウインカの 変更 _ 

[檐能# y. ’ 37 

| 畜式丨 STATUS pusbuinkerCuinker) 

一- ‘ HANDLE winker [A] 新たにカレントとするウイン*のハ〆I••ル 

[戾0拔| [A] 0K 変 E 成功 

ERROR 史 K 失敗 

[解说I カレントウインカをウインカスタックに«み， winker で指定したウイ 

ン*をカレントとします • 

カレントウインカの 復帰 



レ ントウ ィンカの獲# 

t ® t] 39 

式1 HANDLE .currentwinker(void) 

0 ffi I [A] 办レントウイン*のハンドル 

说I :&レントウインカのハンドルを返します。 

インカ情報の獲得 


0 13l] [HL] WIHK 棋造体へのポインタ 
Di ] winker て•指定したウィンカの WINK «边体がある TK レスを返します, 


式 ^ void Jhow(void) 


力ーソルレベルを1滅らし、0になったときにだけカーソルを表示し 
ます。カーソルレベルがすでに0のときも表示され，0以下になること11 
ありません-カーソルがすでに表示されているときは、何もしないで戻り 


すべてのレジスタは保存されます。 



カーソルの 消去 





[s >) 値 I 

Q w s'4 i 


[注意 i 


44 

なし 

阐面上から力ーソルを诮去し、力ーソルレベルに1を加えます。すでに 
i 肖されている場合は何もしません。 

すべてのレジスタは保#されます。 


次の垂直同期までの待機 



18 章 

コントロールマネージャ 


この章では、3ントロールマネージャの*成や备フ r ンクン*ンについて说明します。 

18.1 コントロールマネージャとは 

コントロールマネージャは，画面に表示されるさまざまなコントロール（ツマミ «) を管 
理します，コントロールとは、豳而に表示されるボタン、チ; t ッ クマーク，スクロール パー 
などのことです。コント〇—ルマネージャを使うことにより、これらの管理-を容男にかつ効 
率的に行なうことができます。 

コントロールを使うときは、 a ントロールテンブレー!•というデータ構造に基-づいて，デー 
夕を作成しておかなければなりません。コントロールテンブレートには、コントロールの種 
類と状»、位 a {口ーカル座樣）、大きさなどが格納されます • このコントロールテンブレー 
卜を用；®しておくと、：>ントロールの表示やマウスソルの位 a を指定したコントロ—ル 
の検索、劣睜のコントロールの勅作®墁などが rov に a 述できます。 

また、アブリケ ーX* ンで特殊なコント〇 — . ■■減*登#することもできます。 MSXView 

では、これを*スタムコントロールと呼んでいます，この場合は、コント〇—ルドライパと 
いうモジュールを、 \ISXView のルールにしたがって作成し、そのエントリを登録します。 

18.2 コントロールマネージャの 構成と機能 

コントロールには，システムて •*! 準的に用 S されている「標準コントロ_ル」とアプリケー 
シヨンが定義する 1 ■カスタムコントロール j があリます。コントロールマネージャはこれ 
らをコントロール番号を使って管理します。 


第 18 ij: コント〇— ルマネージャ 




18.2.1 


コントロールテンプレート 


3ント〇—ルは、下のテンプレートにしたが *7 て独作します。 




struct _ctrltp { 
HANDLE mmberi 

WORD xsj 
WORD ys; 

HSG *msg; 

CONTBOL; 


/* コントロール番兮 */ 

/* コント O —ルスイッチ*/ 


/* イ|_効エリア*/ 

/* イ|4肛リア*/ 

/* 冇効エリア*/ 

/* ft 効エリア*/ 

/* 3ンI•口ールメッセージ*/ 


表3.22コント〇—ルテンブレートの内容 


名前 一 _&咔 __ 

コント Q— ル S 号 コン！•ロール S 号とは、3ントロールの杨類を指す番号のこ t 

で.檫準と*スタムがあります。樣準コントロール用は0~63 
までで， 64-255 はカスタムコントロール用です。 
コントロールスイッチコント〇-ルの状!！を設定するスイッチで，ビット単位で指定 
します。 


ビット名尨味 
7 ハイライト 示 


6 マスク 表示されない 

5 ディスエープル _6ndcuU() で検索されない • 

4 ンステム予約 

3 システム予約 

2 システム予約 

1 システム予約 

0 エンド 最後の項目であることを示す 


ft •効エリア そのコントロールの有効エリ 7* が入ります。カーソルの位苗が 

そのコントロールの.1-.にあるかどうか鼉ぺる- testcntl() や、ど 
のコント〇—ルの L にあるかを調べる JinikutlO などて用し 
ます。 

コント〇—ルメッセー各■コントロールのテンプレートアドレスなどが入ります。デー 
ジ タの B およびテンプレートの内容は、&コン！•ロールによって 

興なるので、 （MSG*) でキャストして使； H して T さい • 
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18.2.2 パート番号 

パート S 号とは、1つのコントロールが抱数の®分に分かれているときに、それぞれの部 
分を区別，；2典するために使われる番号のことです。 _findpart() フ7■ンクシヨンを使用する 
ことで、：ソルの位茜がどのバートの上にあるか知ることができます。 

パート番けは1から始めます 《• レパー(つかんで動かすことのできるパートのことをレパー 
と 呼ぶ）のバート番号は128以上です， 

18.2.3 棵準コントロールの機能と使用方法 

樣準コントロ_ルには，以下のようなものがあります。 


表 3.23 椋準3ント〇_ルの梗類 


名前 

意味 

NULL 

何もしません 

ポタン 

中に文字が入った角の九い长プ/杉 

r^Fi 


チユックマ-■ク 

それが遵択されていることを示すマーク 

コントロ _ルボタン 

ON、OFF スィッチ 



横スクロールバ_ 

横方向にスク o— ルさせるツマミ/ 

磁 X クロールパー 

I 

璀方向にスクロールさせるツマミ1 hh 

S 


アイコン 

アイコン 

7レーム 

四角 

ライン 

苗線 

ラウンド 

角の丸い四角 

イレ—ス 

領域の塗 IJ つぶし 

文字列 

文字列の表示 

テキスト«集 

テキストの編集 



556 ® 18¢コントロールマネージャ 

これら樣必コントロールはメヴセージに ft 々のテンプレートアドレスを人れて-叩 encntl() 
や- trackcntlO で使用します。 

各々のテンプレートや棋成は、 18.3 「標！ f コントロールの説明 j を参照して T ■さい。 

18.2.4 カスタムコントロール 

アプリケ—シ 3 ンは樣準コントロールのほかに、のコントロ—ルを加えることができ 
ます。 MSXVicw では、このアブりケーン s ン独0のコントロールのことを•■々スタムコン 
トロール』と呼びます， 

3方式遵択スイソチ、 fi* 計、ダイアル、カラ'-メニューなどアプリケーションは必®に 
応じて: J ントロールドライバ（後^ S) を作成し、それを定義しておけば樣準コントロ_ルと 
同嫌に使用することができます。 

[注® I 々スタムコントロールドライパはアプリケーションエリアに位1するの 

て才-パーレイした場合にそのコントロ_ルを使川すると揉走する恐れが 
あります。 

オーバーレイ先でそのコント〇—ルを使用したい場合■はコント〇—ル 
ドライパの T ドレスをアブリケーシ s ンエリアの卜•位アドレス（例えば 
710 0H 以上）に R いてオーバ_レイモジュールはそれを壞さない人き S 
(例えば、7000 H1-XK) 1こします。 

18.3 標準 コ ン トロ ー ルの説明 

ここでは、椹堆コント〇—ルの内容について M ■明します。 

18.3.1 標準コントロールの定義 

ウインドウのデ7ォルト PEN およぴデフォルト FONT を使用するコント〇 -- ルは以下の 
とおりです。 

•define NULL.CKTL 1 /* NULL «/ 

ffdefine BUTTON.CNTL 2 /* ボタン*〆 

#define MARK.CNTL 3 /• チ * ックマーク*/ 

#define CBTL.CNTL 4 /* コントロールボタン*/ 

#define HBAR.CNTL 5 /» 横スクロールバー*/ 

ffdeflne VBAR.CUTL 6 /» 縦スクロールバー •/ 

#define CICON.OTTL 7 /» 色付きアイコン*/ 

tfdefine IC0N.CNTL 8 /* アイコン*/ 

#define FRAME.CMTL 9 /* フレーム*/ 

ffdefine LINE.CNTL 1〇 ハ線 《/ 

#defme R0UND.CNTL 11 /* 角の丸い四角*/ 

#define ERASE_CNTL 12 /* 1色で塗りつぶす*/ 

#defme STRING.CBTL 13 /* 文字 W */ 

ffdefine TEXT.CNTL 15 /* テキスト •/ 
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t: に* 


ft 



NULL (NULL 一 CNTL) 

I 多式] static CONTROL cntl[J = { NULL . CNTL , sw , xp , yp , xs , 

ys , (HSG *)0 }; 

表ポ丨 なし 
[勘作」 なし 

3ントロールドライパを使い、領域のチ:！■ックを行うために使用されます。 

ボタン （ BUTTON-CNTL) _ 

I 井式 | static CONTROL cntl[]■ { BOTTON.CMTL, sw, xp, yp, 

xb, ys, •文字列-}; 

L * 示丨 角の丸い四角の中に、文字列がセンタリングで表示されます。 

[HD 

[助作Iドラッグ中は，リバースします。 


チェックマーク (MARK CNTL) 






コントロールボタン （CNTL CNTL) 


「式 


static TIST flag 

static CONTROL cntl【]• { CNTL.CNTL, sw, xp, yp, xs 
ya , (HSC *)*flag }; 


flag のオン•オフによって、コントロールマークが表示されます。横力向 
は指■定した領域の左《に.縦方向は中央に表示されます， 






ドラッグ中は、リバースします- 


横乂夕レバー (HBAR CNTL) 


厂 g 式1 


static BARTMP Bcrollh - { 0,100, 20 }; 

static CONTROL cntl[] - { HBAR.CNTL, 8«, xp, yp, xb, 

ys, (HS6 *>kscrollh }; 


表示」 


領域を*すフレームと、のどのあたりを衣示しているかを表すスク〇— 
ルボックXとを*示します。 

钇ゃ“7^ン？め d - 


座スクロールバー (VBAR CNTL ) 

BARTMP 
CONTROL 


I 拜式1 




[勒作 j 播方向に長いオブジェクトの一部が闽面に表示されているとき、その才 

ブジェクトの位 E を移助するために使用しま、スクロールパーのどこを 
クリックされたのかは. Jindpart() で返されるメ<ート番号で知ることがで 
きます，これを利用してオアジ*クトを移觔します。また、ボックスを®； 
接ドラッグしたときは、スタ〇-ルパーテンブレートを参照することによ 
り、指定した位 S を知ることができます。ただし、 -trackcntl() では、スク 
口ールパーは描き直さないので、アプリケーシ a ンが描き直さなければな 
りません， 


ダイアログマネージャを使うと、 COMMAND.func に以下の値が返 1 )ます， 
PAGEU なし（ボックスの上） 

PAGED なし（ボックスの下） 

MOVEV ドラッグ中，スク〇—ルボ.:/クスが觔きます。 


• スクロールパーで使用する定数は以下のとおりです。 


•define PAGEL 1 

•define PAGER 2 

•define PAGEU 3 

^define PAGED 4 

#define HOVEH 128 

•define MOVEV 129 


/* 左べージ */ 

/* 右ぺージ */ 

/* 上べージV 
/* 下ページ*/ 

/* スクロールボックスを検に勒かす*/ 
/* スクロールボックスを縦に動かす*/ 


•スク〇-•ルバーで使用する栴造体は以下のとおりです。 




BARTHP； 





/* 视*の tt */ 

/* 最大値*/ 

/* ページの値*/ 
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LX-COV. • fJTL 

カラーアイコン (ICON CNTL) 

[齐式 i static TINY pat8[ ] » { 〇, 124, 70, 70, 70,126 
62. 0 }; 

static CICON icnnsg - {1 255, pat8 }; 
static CONTROL cntl[] - { tl6s6 CMTL, sw, xp, yp, 
xs, ys, (char *)icnmsg }； 

[* /K ] fe を 1SS したパターンを表ポします • 

[«J J ドラッグ中は，リバースします， 

カラー t イコンで使用される供 a 体は以 k のとおりです • 

COLOR on, 

COLOR off 
TINY »pat, 

> CICOB; 


アイコン (ICON CNTL) 







フレーム (FRAMEgNTL) 

厂廉式 1 static CONTROL cntll ] - { FRAME CNTL, sh, xp, yp 
xs, ys, 0 }j 

[表示』 フレームを描きます。 

[勒 . 作 J なし 


ライン （LINE CNTL) __ 

| 万■式丨 static POS thclineC ] - { { 〇 , 〇 }, { 10 〇 ,1 〇〇 } 

h 

static CONTROL cntl[]■ { LINE.CNTI,, 8», xp, yp, xb, 
ys, (char *)tbeline }j 

[裘示丨 我線を描きます。 

[ Hi I なし 


角 の丸い四 角 (ROUND_CNTL) 
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塗り つぶし (ERASE CNTL) _ 

I S 式1 static CONTROL cntl[) - { ERASE-CNTL, sw, xp, yp 

xs, y s , (char *)UHITE }; 

[S iii 1 傾域を指定した色で*りつぶします。 

I助作.1 ドラッグ中は、リバ'-スします。 

文字列 （STRING CNTL) __ 

I S 式'' static CONTROL entl[] - { STBINO.CNTL, aw, xp, yp 

xs, ys, "文字列-}* 

[表示]指定した位两に文字列を衣示します， 

[ill {V ] ドラッグ中は.リバースします • 

t.01 3>k>-/c 

テキス ト編集 （ TEXT_CNTL) 

| 方式"] static COKTROL cntlt ] - { TEXT.CBTL, aw, xp, yp, xs, 
ys, (TEXT*)taxt }; 

[S ボ]捃定した位 S で文字《編»を行ないます。 

「财作| クり7クでテキスト々ーソルが移抑 L, ドラッグでテキスト内領域を指宏 
します。テキストマネージャを简単に利用するために使用します， 




18.4 コントロールドライパの作成 


コントロールドライパと《、ボタンやチェックマークなどのように，幽而に部品を表示し 
て、ユーザーからのアクシ 3 ンを得るための描幽ルーチンです。コントロールドライパは、 
コントロールマネ--ジャの下位ル--チンになり it . 

コントロールドライバ U、 コントロールマネ_ジャの _setcntl() で、コントロールマネー 
ジャに fi» され、ダイアログマネージャなどから，コントロールマネージャを蛭由して呼び 
出されます。コントロールドライパを作成するには， [A’] にバリエーシヨン番衿を人れ、他 
のレジスタに必要なパラメータを没定し、 -drivecntl() をコールします。 


农3 24コントロ—ルドライパの秘® 


八 iji_ シヨン番 y. 



■S 味_ 

コントロール.の衣示 
コントロ_ルの进択 
パートの検索 
レバーの期始 
レバーの表示 
レ—の消去 
レパーの終了 
コントロールのオープン 
3 ント D —ルのクローズ 


コントロ —ル(••ライパは以下の棣能を»た$なければなりません，しかし、すべて漘たす 
必要はなく、アプリケーシ 3 ンが•必要な檐能だけ作成し、その他はなに fc せずにリターンす 
るだけでもかまいません。 


18.4.1 表記法 

コン)•口 _ルドライパの内杯については、以 F の表 M で說明します。 

コントロールドライバの名前 


[機能# y - _ 
I 存式! 


ント ロール ドライバのパリエーシ 3 ン番号です。 

コントロールマネージャから呼ばれる、コントロールドライハの#式です。 


「解说 I コントロールマネージャの 解 a です。 


コントロールの表示 （DRAW CD ) 

[tt 能#号] 〇 

' ~ ' - CONTROL *cp; [HL]’ 

TINY part; [C] 

(_ 觯 ill 」 コント〇—ルを_面上に描きます。 part が 0 のときは、そのコントロー 

ル全部を、0以外のときは、そのパートだけを描きます。 

3ントロールテンブレートの CONTROLsw によって、表ボ形態が変わ 
らなくて li いけませんが》その表現方法は各コント〇-ルドライパの自由 
です， 


ハイライト 钱霣表示 （例リパ—;〇 

ディスエ_ブル非アクティブ表示（例灰色で表示） 
1のルーチンは dispallcntl() % _dispcntl() で使用されます。 


コントロールの 選択 (SEL CD ) 



ど二卜の検索 （FIND CD) 


I 棰赭#号] 2 


riNY findpartCcp, where) 
CONTROL *cp; [HL] 

POS *wh«re; [OE] 


[解说」 whnre がどのパ-•卜に入っているかを屑べます•バートが 1 つしかない 

ときは、0以外を返すだけでかまいません，コントロールテンプレートで 
指定されているエリアのチェックは心要島りません. 


レバーの検索 (CATCH CD) 


[樯能#号 
[3 ^ 





catchleverCcp, where, part) 





[HU 

[OE] 

[C] 


[W «i ] 


レバーの表示 (DLVR CD) 



レバーの消去 （ FLVR—CD) 


[檐搜_#号| 5 


:XI 


CONTROL 


eraselever(cp, 
*cp; [HL] 
*where; [DE] 
part; [C] 




W 说 レパーを消します。例えば、スクロールボックスを M かすときのラパー 

パンド表示の M 去などに使われます- drawlever() と共通のルーチンでもか 
まいません。コント ロール マネージャは偶数 K 呼びます。 


レバーの終了 (FREE CD) 

[檐能 S 号 6 


[w m 


レパーを dpos の位81で離したことをドライバにえます。 


コントロールのオープン （ OPEN-CD) 
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コントロールのクローズ （CLOSE CD ) 

[機能#号] 8 

| 齐式 | STATUS close(cp) 

CONTROL *cp; [HL] 

Q W W I コントロールドライパをクローズします • -closecntlO で使用されます- 
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18.4.2 標準コントロールのカラー化 
梭準コントロールを任 S の色で描画するときは、カスタムコント ロー ルを作成します。 
各檩準ドライパは、カレントペンで描両を行うので、カスタムドライパは、様準ドライパ 
をぶ前にカレントペンを任.«の色に設定することにより、標準コント〇—ルのカラー化が 
できます。 

カラーコントロ-ルはメッセージを解析し、カレントペンを変®後、コント〇—ルテンブ 
レートを撩コントロール W に®して、樘準コントロールドライパをコールします • 3 ント 
ロールマネージャがペンを保存するので、右ラーコント〇—ルはセーブは行わなくてもかま 
いません， 


18.5 ファンクションー覧 

コントロールマネージャには、以下の77■ンクシ*ンがあります。 


表 3.25 3ント〇—ルマネージャのファンクン a ン ーK 


梭能®兮 

98 

101 

102 

103 

104 

105 
100 

107 

108 

109 

110 

111 

112 


.initcntl() 

■sftcntlQ 

.findpart() 

.dispciitl() 

.dispallcntlQ 



,actioncntl() 

xlosccntlO 



.an. ページ 
コントロールマ本ージャの初期化 571 
カスタムコントロールの W り付け 571 
コントロールのオーブン 572 
パートナンバーの擭得 572 
コン！•ロールの表示 673 
紀列内のコントロールすベての表示 573 
コントロールの実行 574 
コントロール実行中の表示 574 
コントロ—ルのクローズ 575 
K 列内のコントロールすベての才ープン S7S 
ttfi の座標がコントロールに含まれるかの 576 
検索 

指定した座樣を含むコント〇—ルの検索 S76 
コントロールドライパの|£核呼び出し 577 
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18.6 ファンクションの 説明 

以下では，コントロールマネージャの各フアンクシ3ンについて説明します • 


18.6.1 表記法 

フ T ンクシヨンの说明では、次のよつに表 2 d します。 


ファンクションの機能を示します 


[機能*号]各ファンクシ S ンに910当てられている*号です。 


[ «式 I 各77•ンクシヨンを使用する ts の？ r 式を示します • 


I-7アンクシ，ンの W"SU0E 

|-フアンクシ》ン名 

1 |- 9181 

STATUS .clearuin<um) 

HANDLE win [A] ウインドウハンドル 
! —が数の S 眛 

——が»の受け波しに使われる CPU レジスタ 
(アセンブラブログラミング時に使用） 

—' 31»2 

— 51ft の S! 

「戾り値| そのフ7■ンクシヨンの助作の結果、どのような ffi が返されるかを 

示します。 

[A] 0K オーブン成功 

ERROR オーブン失敗 

! 丨-現り«の S 味 

1 - W り餹 

1 -屏り tt の 51 き*し tc 使われる CPU レジスタ 

(7 ■センブラブログラム時 K«eim 


[解说丨 その77■ンクシヨンがどのような»作をするかを示します。 
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18.6 フアンクシ s ンの 31 明 


571 



カスタムコントロールの割り付け_ 

[梭能*号]101 

丨方式 HANDLE setcntlCtunc, cntl} 

‘ TINY (*func)<) [HL] ドライパのアト•レス 

HANDLE cntl [E ] コントロールのハンドル 

「圾〇 « ] [A] 成功した場合、；51)*)付けられたコ ントロールのハンドル 

失敗した場合， ERROR 



ルは64~127でなければなりません， cntl が0のときは、新しいハンドル 
を2110付けます。特に a 由のない限り、新しいハント•ルを刺り当てて下さ 
い*すでに割0当ててあるハンドルに期り付けることもできるので、オー 
パーレイ先で，間遠って他のアブリケ■シ3ンの W り付けを壊す可能性が 
あります- 





コントロールのオープン 


STATUS -.opencntX Cctemp) 

CONTROL *ctemp [HL] CONTROL 檐造体へのポインタ 


[戻り侦 1 [A] OK オーブン成功 

ERROR オーブン失敗 


I解珙 ] 3ントロールを3ントロールテンプレートとメッセージにしたがって 

オープンし、そのコントロールを使用できるようにします • ffi 拳コントロー 
ルのほとんどはオーブンしなく t も使川できますが，初期化を必要とする 
ようなコントロールドライでは、このフ7■ンクシ9ンを使用します《 


パート番号の獲得 



配列内の コントロールすベての 表示 



コントロー ルの実行 


携能» y 106 


CE 


!□ 


CONTROL 


(C [hlT’ 


part [A*] 
•event [DE] 
(*func) <) [BC] 


part, event, («func)0) 
COMTOOL 構造体へのポインタ 
パート番号 

イベンI•構 a 体へのポインタ 
コールパックルーチンのアドレス 


[戻り [ A] TRUE 正常に*行終了 

FALSE 異常終了 


[解 K 丨 3ントロールを実行します， 1st ボタンが離されるまで制御は戻ってき 

ませんが、このルーチンは 1st ポタンが押されている間中、操り返しむわれ 
る％理を行うルーチン（コールパックルーチン）の func を呼び続けます， 
コールパックルーチンのアト•レスを*すと、それに対応する肋作をします。 
コ—ルパックが必要でないときは、 NULL (OOOOH) を渡します。パート 
番号が W8 以上のときは，レパーを示します。 


コールパックルーチンへの51数は以 T の通9です„ 


func(ctmnp, pos, part) 

*ctenp [HL] コントロールテンブレート 
*pos [DE] ロー 方ル座椋 
part [C] パート番号 


コントロール 実行中の表示 


〔播能#号]107 


If 式 ] 


CONTROL «ctemp [HL] C0NTR0I •構造体へのポインタ 

TINY su [E] 

TINT part [C] 


[戻り値」 なし 


「解说 | コントロールが a 択され、実行中であるということを示す表示を行いま 

す。 sw が1のときは表示、0のと Sli は解除を行います，このルーチンは 
コントロールドライパの selectcntlQ S コールします。 



コントロールのクローズ 


I 後01壽兮 I 108 

1兹式 STATUS closecntX(cteop) 

CONTHOL *ctemp [HL] CONTRQI •構造体へのポインタ 

[« 'J «] [*] OK ク O- ズ成功 

ERROR クローズ失敗 


解 m ] 3 ント D— ルをクローズします。0準コントルのはとんど《この 

ル—チンを*行しても何もしませんが、終了*4環を必要とするような3ント 
ロールドライパで li、 このフ r ンクン9ンを： 3- ルしなければな t) ません, 


配列内のコントロールすベてのオープン 


I榱能番号 1 
1101 ] 
I戻り tt] 


[Z 
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STATUS .openallcntl(cteDp) 

CONTROL *ctemp [HU CONTROL 構造体の配列へのポインタ 

[A] OK オープン成功 

ERROR オ_ブン失敗 

ctemp にコント〇—ルテンプレ-卜の K 列の先敢アドレスを入れてこの 
1 1— チンをコールすると， CONTROL.sw の FIN が1になっている3ント 
ロールがあるまで、すべてのコントロールに対して、 jjpencntl() がコール 


し、 CONTROLsw 



任意の座標がコントロールに含まれるかの検索 


[« *6 * v -] 110 


BOOL .testcntKcteap, where) 

CONTROL *ctemp [HI.] コント O —ル播造体へのボインタ 
POS *«here [DE] ル座標 


[K り® I [*] TRUE 含まれる 

FALSE 含まれない 


W 说| where で指定された住«の#檁が、 ttemp で指定されたコン!•口ール 

に含まれているかどうかを*ぺます。序揉はそのコントロールのあるウィ 
ンドウの〇_冷ル座抵です„含まれていたら TRUE、 そうでなかったら 
FALSE を返します。 


指定した座標を含むコントロールの検索 
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コントロールドライバの曼接呼び出し 

I梭能#号]112 

一 CONTROL *ctemp [HL] CONTROL 供造体へのポインタ 

POS *uhere CDE] コント ロー ルの 〇 — 々ル座梯 

TINY part [BC] パート番砭 

TXHY vnun [*'] 

I供0 [A] ドライ八の实行結采 

[解説丨 コント〇—ルドライパを it 接呼び出します•カレントペン、々レント 

フォント11保#しません.#常に低レペルなルーチンなので、扱いに注® 
して1••さい • このルーチンの目的は«準コントロールを々ラー化すること 
ですが、樣单コントロ_ルを使いやすくすることもできます。 



19 章 



この章では、メニューマネージャの構成や各ファンクシ S ンについて说明します。 

19.1 メニューマネージャとは 

メニューマネージャは、 MSXView の棵準的なューザーインターフェイスの1つである 1 ■文 
宇列メニュー j をサボートするためのマネージャです。通常のアブりケー ジョンでは、 
ューザーが扱い易いようなメニューの苷灌はたいへん面倒ですが、 MSXView では、メニュー 
内に表示する文字列を所定のデータ形式で並べるだけで、メニューの大きさや配 S にいたる 
まで、メニューマネージャが管理します。メニューはポインティングデパイスを使用しても 
キーボードを使用して4、 （8 单に選択できます。 

メニ*-マネージャは、•■メニューバーム••ボップアップ j などのメニュ—を管理します。 
基本的に、メニューは現在の力ーソル位 B を中心とした位 S に表示されます。橫は画面いっ 
ばいに、播はツールボックスなどに*ならないように、上*の Y 座榡が16~212までに自動 
的に拥整されます。ボップアップの大きさはメニューテンプレートの内容により、自動的に 
最小の大き5に投定されます。表示するメニューの内容は、 IB 則として文字列で梅成5れま 
す。さらに、それぞれの項 B に以下のような成性が指定できます • 

• チ》ックマ_クをつける- 
• 項目表示を«止する。 

• メニュ■を灰色にし进択できなくする。 

• 両端に線をつける， 

■ 文字列をセンタリングする。 

• 太字にする。 

• 1行に複数の文字列を盖ベる， 


セン5リンク 
チ iv ク？づ 


llTt'：B 雕した ■ メニュー B| 

FIN 
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また、キーポードを使ってワンタッチでメニューを进択で3るようIこするため、メニュー 
の要素ごとにキ ー3-1 ••が指定できます* 

メニューの役割 U、 ポインティングデパイスまたはキーボードによって，文 t 列項 H の一 
K の中から特定の項目を进ぴ出すことです，メニュー H 体《それ以上の勒<节は行いません。 

19.2 メニューマネージャの使い方 

メニューマネージャを使うには、表35するメニュー形状を定其-する 1 ■メニューテンブレー 
卜 j を用意しておき，必要に応じて各 W のルーチンを n — ルします。 

19.3 メニューマネージャの構成と機能 

メニ a ■— は®準的に、「クイI•ルパー J, r DA パー」、「コマンドパ ーJ を M いてお S、 メ 
ニューがクリックされることによって、ボップアップが才ーブンします， 



B 3-5 メニューパーの各部の名称 


19.3.1 タイトルパー 

タイトルパーは、文咨ウインドウに対する搡作を遵択するためのメニューで、通常両面•の 
左上にオーブンします。 

ここには、7ァイル*4理、印刷，終了などのメニューが入っています。通常、タイトルパー 
には、 現在編! t 中のフ T イル名を表示します。ただし.編*中のファイルが新規作成中の場 
合には， 1 ■新規^あるいはそのアブ 1 J ヶー•〆》ンの名前を*示します。通常の起動時には、ア 
ブリケ•ーシ3ン名を入れます。 

-ft 的に、ここに入るメニューの内容は次のようなものです. 
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衣 3.26 タイトルパーの内容 

mt 意味 

新81 tem 内容を破*して初期状®にします。 

保苻 wm 内容に名前をつけて保存します- 

史斯 iSHs 内容を a み込んだ t きの名# i で伐合します。 

:4込 保#してあったデ-夕をディスクから嫌み込みます。 

mk C •■糸形式のデ-■夕交 «7r イルを作ります。 

姐込 枕傘形式のデータ交}*ファイルを姐み込みます， 

卬刷 印刷を行います。 

印刷形式 FP 刷衫式の SKE を行い i す- 
終 f アブり y- シ9ンを終了し、 VSHELUCR リます • 


19.3.2 DA (デスクアクセサリ）パー 

DA バーは、デスクアクセサリを起動するためのメニューで、デスクアクセサリメニュー 
が入っています。通常このメニュ-■は、タイトルメニューのすぐ右にオーブンされます。 

DA バーの％瑰については，システムマネージャの- openda(), -closeda()、Jrivesystem() 
を参照して下さい。アプリケーシ3ンは、これらのフ7■ンク vs ンを呼び出すだけで， DA 
バーに明する塊は名成する必ではありません。 

19.3.3 コマンドパー 

コマン:、*パーには、アブリケーシ 3 ンの各メニューが人っています。この部分のメニュー 
の内稃は.アブ”ケーシ 9 ンに依？?.しま1—。アブりケ ーV* ン»自の逡 ft (棰阳を*択す 
るためのメニューで、肉面の右I•.に表示します。 

妯 Q の道具（機能）に対するボップアップはアブりケーシ3ンが定義し、必要な地理.を 
行います。 


19.3.4 ポップアップ 

ボンブア •/ ブは、文字列を屮（，にした項自を、マーカーによってポインティングデパイス 
キーボードどちらからでも®串•に iK 択できるようになっているメニュ■•です。 

ボップ7■ッフは、 f 独にオーブンして送択することもできますが，通常(ムメニューのテ 
ンプレー！•の中に定義し自 M 的に択するようにします • 現在の力ーソル位 S を中心とした 
位 SI に表示され^横は画ていっぱいに、縦はツールボックスなどに®ならないように、 16- 
211 ド y 卜の大きさに自勐的に制限されます • ポップアップの大きさは、デンブレートによっ 
て ft W 的にに;»定されます， 



ボ y ブア •/ ブが表示された瞬間には-マーカーは表示されておらず • マウスカーソルが動 
いた瞬間に、カーソルに最も近いアイテムにマーカーが表示されます。ドラッグしなくても 
マーカーはボインティングカ ーy ルに追保します•ボインテイングカーソルがメニューの外 
に出たときは.マーカーは消えます。マウスカーソルが止まっている状態て％カーソルキー 
が押されると.それにしたがってマーカーが移動します。その時点でポインティングデパイ 
ス（多くの場合、マウス）が勤いたら、即座にポインティングカーソルの近くにマーカーが 

移®します。 

__メニューの選択は、マーカーが出ている状 S で 1st ポタン（右ボタン）をクリックするか， 

I select ! キー，キー、 ispaceI キーを押します,キャンセルは，マーカーが m えてい 
る状逸で 2ml ボタン（左ボタン）クリックするか、 I STOP] キーまたは fescl キーを押し 
ます， 


19.3.5 メニューテンプI ■»— 卜 
メニューの表示には、以下の2種類のテンプレートを使用します。 




.popup •( 
keycode; 


/* ヘッダ*/ 
/* キーコード 

/• 項 U 名*/ 


typedef etruct 


POPUP 


_11180 utp { 
keycode : 


/* ヘッダ，/ 

/* キーコード*〆 

/* 項0名 •/ 

/• ボップアップのテンブレー!'*/ 


表3 27 メニューテンプレートの内容 


サイズ ■■ 



19.3 メニューマネージャの構成と楼能 




名前 サイス ft 味 

ビット £味 

6 マスク項日表示を策止します 〇 

0項 B 表示 

1項目表示なし、道択不可能 
5 ディスエ_プル項目进択を S 止します。 

マスクビットが立っているときは、マスクが後先し 
ます。 

0通常黒色で表示し、进択可能 
1通常灰色で*示し.選択不可 
4 楝項 B の区切りを表現します， 

0通常 

1文字列をセンタリングし両側に線を描き、 
選択できなくします。 

3 センタリング項目名をセンタ li ングします。 

0 通常 

1項目名をセンタりングします。 

2 太字項 B 名を大字で*示します。 

0 通常 

1文字を太字にします。 

1 コンティニューこの項目で改行をせずに、次の項 

H を横に嫌けて表示します。 

0改行します- 

1 TAB を人れます • 改行しません， 

0 エンドテンブレ—卜の®後の項目のこのビットを 

立てることで、メニューマネージャが項目の個数を 
知ることができます。 

0 通常 
1铋後の項目 



文字列の&後に表示し.このキーと （^ raphI キーを M 時に押 
す、あるいはフアンクシ3ンキーを押すことで、この項！ ■! を遘 




58ft ■方 19 ft メニューマネージャ 


19.5 ファンクションの説明 

以下では、メニューマネージャの各7ァンクシヨンについて进明します。 


19.5.1 表記法 

7 7■ンクン3ンの81明では、次のように*紀します。 


ファンクションの機能ををします 

[梭 flg 番皆' 各ファンクションに袖り当てられている#号です。 

[ » 式丨 各フ7■ンクシ3ンを使用するときの誉式を示します- 

フアンクシ3ンの庹リ依《型 
フアンクシ3ン名 
引数 


HANDLE win [A] ウインドウハンドル 
引 ft の：®味 

づ|数の受け漉しに®われる CPU レジスタ 
<7•センブラプログラミング時に使用） 

«IRf. 

引故の M 

〔员り侦， そのフ7•ンクシ3ンの動作の轱果、どのような攸が返されるかを 


[A] OK オーブン成功 

ERROR オープン失:敗 

I-戻り秋の S 味 

1 -«”《 

1 - s り嬢の…き*しに使われる cpu レジスタ 

(アセンブラプ〇グラム時に使 

[M % ] そのファンクシ3ンがどのような®作をするかを示します。 





メニューマネージャの初期化 


[機能番号] 15* 

丨甚式 ] void initmenu (void) 
り値 | なし 


[w a ] メニューマネージャを初期化します。チ I ックマークバターンを a 定し 

たり、ハイライトやメユューハンドルをクリアします„このファンクショ 
ンはシステムが自動的に其行するので、アブリケーシ a ンから呼び出す必 
要はありません， 


メニューのオープン 



メニューのクローズ 


|梭《«疗| 

I g 式 I 

I 戻り碴丨 


[ 说] ハンドルで报定されたウインドウを削除し，メニューハンドルを解放し 

ます。ウィンドウマネージャの _delet«win() を使用すると、ウインドウだ 
けが削除され，メニューハンドルは解放されません • メニューが不必要に 
なったら、必ずこの7アンクシ 3 ンをコールして下さい。 


メニュー項目が選択されたときの処理 


S 式 I 


[ 戻り fA] 


COMMAND »coo [HL] COMMAHD 携:造体へのポインタ 
POS *where [0 E] POS 供造)^へのポインタ 


where で梅定した位 E が，規在朗かれてい4メニューに入っていれば、 
メニュー項目の強«とポップアップ衣示をし、力ーソルの助きを追って選 
択された項目#号を com に格納します，ボップアップの外側がクリックさ 
れたときは、そのイベントをイベントキューに戻し （_ungetevent() する） 
FALSE を返します。 TRUE が返ったときは、メニ•-項 H の強調がその 
まま C なっているので、 JiiliteO をコールして、強典を*?除して下さい， 




[> d 


BOOL JceymenuCcom, afaere, keycode) 

COMMAND *com [KL] COMMAND 携造体へのポインタ 
POS *«here [DE] POSffi 造体へのポインタ 
char keycode [C] キーコ■•ド 


「戾り Vl | [A] TRUE 項目が遵択された 

FALSE »当する項自がなく、进択されなかった 
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解说 ] 争えられたキー:!ードを，メニ1一とボップアップのテンプレートから 
拽して®択します。項 B が M したときはその項 H を強珣します。 

選択された項 B がメニのチンブレ -I •にあったたときは、ボヴブアツ 
ブを表示して々ーソルをドライプし、その項 H 番号を返します。遵択され 
た項 B がポップアップのチンブレートにあったと#は、ただちにその項目 
番号を返します。 

»当する項目がなかった場合には何もせず FALSE が返されます。 TRUE 
が返ったときには、項目の強調はそのままになっているので， Jiilite() を 
コールして強 M を解除して下さい， 


メニュー項目の強調 



| 丧式 | void Jllllte(coD) 

COMMAND *com [HL] COMMAND 構造体へのポインタ 

[ row ] なし 

f 解说’ 指定したメニューの項目を強*！します。ポップアップの項目指定は無祝 

されます。 com が NULL のときは、強綢を解除します。 


/ ニュー内のイ 1 ントのテスト 

[檐能番号 j 158 

[并 _ 式 I BOOL _iamenu(eveDt) 

EVENT *ewent [HLJ EVENT 供•造体へのポインタ 

[A] THDE メニュー内でイベントがあった 
FALSE メニュー内で (i なかった 

event で推定したイベントが、メニュー内で起きたものかどうかを返し 
ます。 


ポ4プ7 wp の処理 



19.5 7 アンクシ 3 ンの説 MJJ 
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ポップアップでのショートカットキ ー g 理 

[檐68 # 5- 1 160 

卦 A , TINY _keypopup(temp, keycode) 

PDPDP *tanp [HL] POPUP® 造体へのポインタ 
char keycode [E] キー： >— ド 

り ttt] [A] 邀択された項 U 番号 

何も*択されなかった塢含〇 

[解 a ] ボップアップは表示せずに、テンプレートにしたがってキーコードを 

チェックし、进択された項 H 番号を返しま1% 



20 章 

ダイアログマネージャ 


この家では、ダイアログマネージャの W 成や各フアンクシ3ンについて说明します， 

20.1ダイアログマネージャとは 

ダイアログマネージャ li、MSXView アブリケーシ3ンがユーザーからの応答を得るため 
のルーチン群です。 

内®的には、ディXプレイマネージャとコントロールマネージャを呼び出して ，ユーザー 
の道択を返します • 

20.2 フアンクシヨンー覧 

ダイアログマネージャには、以下のフアンクシ3ンがあります， 


表 3.29 ダイアログマネージャのファンク-〆3ンー "S 


榛能番号名 W 

257 .uutdlgO 

258 J>pendlg() 

259 xlosedlg() 

260 .dlgselect() 

261 jno<Wdlg() 

262 ^x>pupdlg() 


263 

373 



.errmessageQ 


重眛 ぺージ 

ダイアログマネージャの初期化 59T 

ダイアログボックスの表示 595 

ダイアログボックスのクローズ 595 

ダイアログ上のアクシ3ンの播得 596 

モーダルダイアログのアクションの棰得 596 

ボップアップダイアログの表示とアクシ3 597 

ンの推得 

メッセージダイアログボックスの表示 597 

メッセージダイアログボックスの表示2 598 



20.3 ファンクションの説明 

以下では，タイアログマネージャの备77■ンクシ3ンについて ill 明します。 


20.3.1 表記法 

フ7•ンクシ3ンの说明では、次のよフに表纪します， 


ファンクションの機能を示します 


機能# y] 各フアンクシ3ンに w り当てられている®号です。 


斑 1 )疵 I 


各フ7•ンクシ S ンを»用するときの并式を示します。 




— 引数の：®味 

— 01数の受け波しに使われる CPU レジスタ 
(アセンブラブログラ i ング時に使用） 

一引款名 
一引数の 


そのフ7•ンクシ S ンの助 ft: •の結果.どのような値が返されるかを 
示します。 


[A] 0K オーブン成;功 

ERROR オーブン失敗 

«リ餹の«味 

Km 

の引き»しに使われる CPU レジスタ 
(アセンブラブログラム！»に使甩> 

r W in ； その 7 ァンクシ * ンがどのような勒作をするかを示します。 




20.3フ T ンクシ a ンの说明 
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ダイアログマネージャの初期化 

能番 y- 丨207 


HTF1 

[ 成 1 ) m | 
「 w 说 ] 


なし 

ダイアログマネージャを初期化します。このファンクシ3ンはシステ 
ムが H 動的に実 iT するので、アブリケーシ3ンから呼び出す必要はありま 
せん。 


ダイアログボックスの表示_ 

[植能#号] 258 

1 S— 式! HANDLE .opendlgCarea, style, uia, pen, font, temp) 

1 AREA »area [HL] ダイアログボックスを表示するェ U ア 

TINY style [E] ダイアログボックスの形状 

HANDLE win [C] クインドクハンドル 

HANDLE pen [A’] ペンハンドル 

HANDLE font [E 1 ] フォントハンドル 

CONTROL *tenp [BC*] 3 ン 1 •口ー ルへのポインタ 

[¢5 0 « I [A] ダイアログハンドル 

[解说丨 指定されたダイア〇グボックスを*示します。 


ダイアログボックスのクローズ 



| S 式 void .closedlg(dlog) 

HANDLE dlog [A] ダイアログハンドル 


[* ') tel なし 

[#? iit ] <Hog て-指定 L たダイアログボックスをクローズします。 




アログ上のアクシ j ンの獲得 

[n RS # ' 4 ] 260 


厂 -S 式 I 


HANDLE 

EVENT 

COMHAND 


.dlgselectCdlog, 
dlog [A] 

»event [DE] 


ダイア〇グハンドル 
EVENT 柄造体へのボイ'✓夕 
COMMAND W 造体へのポインタ 


[® 9 fA : W TRUE 何か进択された 

FALSE 何も選択されなかった 


[鮮说 I -upendlgO で作成したダイアログへのユーザーの応答を返します • dlog 

には、 .opciidlgO で S つて S たハンドル* y •をセブトします. command 
に- open ( llg() でセツトした^コン！ルテンプレート屮の迸択されたア 
イテム <Sd 列の要索#り-)が返されます。 


モーダルダイアログのアクシヨンの獲得 



ポップアップダイアログの表示とアクシヨンの獲得 


I"嫌能番号 j 262 


HANDLE 

HANDLE 

CONTROL 


*area [ HL ] 

style [E] 

center [BC] 

pen [鼻’] 

font tE»] 

•temp [BC*] 


ダイアログボックスを表示するエリア 
ダイアログボックスの形状 
表示位! S 

ペンハンドル 

フォントハンドル 

コントロールへのボインタ 


[戾り® [1 [A] ERROR 以外道択されたアイテム 

ERROR 何 6* 択されなかった 


[ « 説] center で播定された位 S を中心と L て、画面におさまるように自助的に 

表示位 E を MS したダイアログを*示し、ユーザーのアクシ*ンを得て_ 
その結果を返します。結果はコントルテンプレートのアイテム（配列 
の要索#号）で®されます。 


メッセージダイアログの表示 





第 20 車ダイアログマネージャ 


メ ッ セージダイアログの表示2 


檐能 * 号 | 373 




char »m8g Sf 示する文字列へのボインタ 
char *icon アイコンパターンへのボインタ 
char *btn[] ボタン文字列の K 列へのポインタ 


[« '； ffi] [« ボタン®号 

[解说| アイコンと文字列およびボタンを表示して，どのボタンが左クリック 

されたかを、ボタンの番号で返します。ゲえるボタン文字列の配列の*後 
は、終了を®味するために NULL を K きます ■> ボタンは1~3です， 

右クリックされると、 K 大のボタン#号を返します。 

例えば2つのボタン文字列の KW は以下のよつにします。 


char *htn[] - { ■ボタン 1", •■ボタン 2", HULL }; 

この埔合、ポタン1が左クリックされると0が、ボタン2が左クリックさ 
れると1が返ります。マウスカーソルがどこであれ右クリックされると 
1を返すので、一番*後のボタンは 1 ■中止 j などを进択するために使用し 
ます。 



21 章 

その他のマネージャ 


この京では、今まで解 K した以外のマネージャの各フアンクシ3ンについて说明します。 
その他のマネージャ t しては，以下のものがあります， 

• システムマネージャ 
• キーマップマネージャ 
• サウンドマネージャ 
• メモリマネージャ 
•ブリントマネージャ 

21.1 フアンクシヨンー覧 

その他のマネージャには、以下のフ7•ンクン3ンがあります。 


表3_30システムマネージャのフアンタシ3ンー鶩 


檐能番夺 ■■ 

1 .wr^ysdataO 

6 _rd_sysdata() 

293 .openda() 

294 .closeda() 

295 ^IrivesystemO 

301 ^ndview() 

307 -setdate() 

308 -getdate() 

309 -settirae() 

310 >gettime() 

372 _sho«rtitle() 

410 jiosexecO 


システムデ-■夕の# s 込み 
システムデータの嫌み出し 
DA メニューのオーブン 
DA メニューのク〇—ズ 
DA の処理 
MSXView の終了 
日付の器:定 
日付の摧得 
時刻の設定 
時刻の癢得 
タイトルの表示 
DOS コマンドの実行 


ベー ジ 
— 602" 
602 
603 
603 

603 

604 
604 

604 

605 
605 


600 
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衣 3.31 キーマップマネージヤのフ T ■ンクシ3ン ーS 


2S. r i mitkf) in.ip() 

286 _getkeyfunc() 


キーマップマネージャの初期化 607 

棰能コードの獲得 607 

•2M - rmiiiwwtllwvM 榼能コ ー J£ fnv-y ヒ^» V- - 608 

288 ^etalphkeyO 梭能コードがマッピングされているキーの 610 

搜得 

289 -getjekyfuncO 楢能コードの®得 610 

291 jetkeymap() キーマップの设定 610 

292 .getkeyniapO キ―マップの播得 611 


表332サウント•マネージャのフアンクンヨンー览 

梭能番号名前 

"361 _pcmplayi) PdH の#? E 612 

369 .pcmrecO PCM の録音 612 


表 3.33 メモリマネージャのフアンクシヨン HE 


棵能番号 


味 


.initmemoryO 

jbrk() 

-free() 

jnalloc() 

_closevb() 

.writevb() 

jeadvb() 


メモリマネージャの初期化 
データ領域の大きさの変® 
メモリプ〇ックの解放 
メモリプロックの播得 
VRAM パッフ7•のオーブン 
VRAM パッフ7■のクローズ 
VRAM バッファへの咨き込み 
VRAM バッフ7•からの説み出し 


~614~ 

614 

615 
615 

615 

616 
616 
617 


表 3.34 ブリントマネージヤのフアンクシ3ンー轚 

概齙番号名成 

311 JnitpHntO デリン f マ冬--ジャの 初期 ？ fc 

312 -chpd() ブリンタドライバの変 SE 

313 printinfo() ブリント情報の獲得 

314 _ -pd() _プリンタドライバの起勒_ 


ぺージ 

62T 

624 

624 

625 







ファンクシヨンの機能を示します 




システムデータの 書き込み 

@ fis * y] 1 


齐 A 




address [HL] システムデ-夕 7r ■イルの T トレス 
•lata [E] 苔3込むデータ 


[戾 «U なし 

[觯规 I MSXView システムデータエリアの address て•指定したアト • レスIこ， data 

で定したデータを*5込みます。システムデータエリアにはパレット愤 
報やボインチィングデパイスのなど、 MSXView が内部的に参照する 
ffl 報がおさめられています0システムデータエリアの内容は、 MSXView 
起如時に 「pref.mvj 77■イルから统み込まれ、終丁時に#き出されます。 
システムデータエリアの内容およびアドレスは将來変更される可能性があ 
るので、各情相を参照•変 K すると$には、個別のアクセス W フ7•ンクショ 
ンを使用して下さい， 


システムデータの 読み出し 



DA メニューのオープン 


[_ 機能番马 293 


菩式 ] HANDLE opendatx , y ) 

int x [ HL ] 枝:方向のグ O- ■パル■.檫 
int y [DE] 縦方向のグローハ•ル■■標 


り値！ [A] M メニューのハンドル 
[解说] X、 y の位黄を左. l-.fc して、 DA メニューをオーブンします • 


DA メニューのクローズ 

[榼能# 294 

丨袅式 | void .closeda(void) 

[庚 1 )値丨 なし 


[W id I DA / ニューをクローズ します- 


DA の処理 



MSXView の終了 

I檐能番号] 301 

[戻 1 ) fifi] »f び fll し元1こ《5?0ません 

[解说丨 MSXView を終了して、 MSX-DOS2 に皮ります。終了前に MSXView 
力ーネル内部のデータは、以ドの環境変数で示すデイレクトリにある 1 ' 
PREF'.MVj に保存されます。 


MSXView のパ*-ジ9ン 


设境変数 
VIEW 
VIEW 
VIEWDATA 


日付の設定 


[機能番号， 307 

| -S 式 void -setdate(date) 

DATE *date [HL] DATE 構造体へのポインタ 


[戻り tt なし 


[解！！ i1 date で指定した日付を、現在の H 付として狡定します。 


日付の獲得 



時刻の設定 


[機能番号 




ri~^n 


void -sertina(tiae) 

TIME *tima [HL] TIME 構造休へのポインタ 


[M り値」 なし 

[W a time で推定した時刻を、現在の時刻として狡定します， 


時刻の獲得 _ 

丨檐能 $ 号 310 

| 害•'，式1 void ^ettlme(tiDe) 

TIME *time [HL] TIME 構进体へのポインタ 

I 戾9値]なし 

[ » 说丨 time に規在の時刻を返します。 


タイトルの表示 
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DOS コマンドの実行 



= char *cmd [HL] COHMAND2.COM に波す実行コマンド行 


0値丨 呼び出し元には戻りません 

| W 说| MSXView から COMMAND2_COM を呼び出して、 and で报定された 
DOS コマンドを戈行します。 cmd が播定するコマンド行は，127バイト以 
F でなければなりません，この 7r ンクシヨンは呼び出し元には K らず、 
VSHELL に戻るので、これを呼び出すアブリケーンョンブ〇グラムは、呼 
び出し萌に終了*!珲を行わなくてはなりません。 

COMMAND2.COM が呼び出される荊には， MSXView を終了させると 
き tlSJ じ) Q 理が行われます。スクリーンモードは、 MSXView が起舫した 
ときのモードに戾します。 

DOS 3マント•の*行が終ると， 



と表示 U 何かキーを押すと、 MSXView の VSHELL に戻ります。 


MSXView が COMMAND2.COM を呼び出すとき U、S 境変数の SHELL 
を参照しているので、 SHELL を別に； S 定すると、そのブログラムを呼び 
出すことができます， 

また、 SHELL が S 定されていないときは、 r A:¥COMMAND2.COMj 
が呼び出されます，1^乂外《«が008 3マンド〇1«1を败すと$は、 81H 
-0FTHS 地にその内容を、 80H 番地に文字数を格納しています • 

このファンク'〆3ンは、 MSXViewversion 1.20以上で使用できます。 



キー マッ プマネージャの初期化 


[描能番兮] 285 

| ^■式 | void initkeymap(void) 

') ffi] tt\, 

("W 我 I キー 7 ップ マネージャを初期化します。このファン クシ 3ンは シス テ 

ムが自勳( I 勺に実0するので、アブリケー シ s ンから呼び出す必要はありま 
せん， 


機 能コードの 獲得 

[描能番号 286 


[H ] 


[(» M 


TIHY .g*tk«yfunc(event) 

EVENT *event [HL] イベント構造体へのポインタ 

[A] 機能コードを返します。ただし，以下の場合は、0を返します 
与えられたイベントがキーボードイベントではないとき 
特殊 キー ではなく、 (CTRL) キー も押されていないとき 
•ICTRL] キーとの組み合せに、何もマップされていないと S 

なえられたキーイベントに対して、マップされている梭能コードを返し 
ます，ただし，特殊キー (I1NSL fDELl 15^ d など）には，あらかじ 
め特定の榱能コードがマップされているので.特珠キーイベントを宇え4 


とその梭能コードが返ります，これにより，[^)キ_の代わりに， fCTRLI 
+ 1MJ キーを使 >u したり， (Is |キーの代わりに， |CTg^ + (D キーを使 
用することもできます，打任^キ- 




特定のキーと |CTRL| 令^との姐み合せに対して，テキスト編*のため 
の榱能をマッピングしますなシステムで11、 ( bTRL~l キーと英字 
キーとの組み廿で.いろいろな縐 fc» 能が使えるようになってい i す•し 
かし、 MSXView で (i, |CTRin + 英字 UCTRLl +fe 字キー. (CTRL) 
> シ》ンキー、 「CTRLI + 待珠 A の組 A 合■わせ l lJ *• 。 _ 

ぃまち \ 

«巢檐能には、以 T のようなフアンクン3ンコードが 91 り当てられてい 
ます。以下は、樣唞インクルード77■イルの <keydefc.h> 内で定*されて 
ぃる内容です。 


_細 

助|»頭# 

// 移移先格 ►/►/ 
//// * /-MTh-*- * * 

* * * * 動觔*ジジスス助動 
觔助助動移移ム I Iキキ移移/ 
移移移移！ g 末一ぺぺテテ上げ* 
上下左右行行ホ11をを行行沐 

ルルルルルルルルルルル11§ 

ソ yvyvyvy ソソソをを冉 
I I I I I I I I I I 一面 is •面 
力力*力*力力力力力#画興}I 

1111 Ellli 


== i 




挿人と M 除 


212 フ T ンクシヨンの! ft 明 




#define TOCGLEINSERT 
*define DELETELEFT 
#define OELCTERIGHT 
#defin« INSERTLINE 
#defme OELETELINE 
#defin« OELETETOEOL 
#define OELRANGE 
/* 


OxlO /* 挿入そードの切り換え*/ 

Oxll /* ル左削除*〆 

0x12 I * 力- ソル右則除*/ 

0x13 /* lii •抻入*/ 

0*14 /* 1« 削除*/ 

0x15 /* 3¢— ゾルから行末までの削除*/ 

0x16 /* レンジ道択されて！•、る埸戸斤を削除する*/ 

その他の樘能 


•/ 

#define TOCXSLESELECT 0x80 

#defina STARTSELECT 0x81 

#defin« STOPSELECT 0x82 

#defin« SELECTCHAR 0x83 

#defin« SELECTUORD 0x84 

Itdefia* SELECTLINE 0x85 

tfdefine SELECTPARAGRAPH 0x86 
*defio« COTTEXT 0x87 

*defin« COPYTEXT 0x88 

ffdefine PASTETEXT 0x89 

#defin« SETCBRSOR 0x8a 

((define SETSCREBJ 0x8b 

/♦ 

•* 行殊キー 

*/ 

#dafin« RETURKKEY 0x90 

#defin« SFTRETKEY 0x91 

#define SPACEKEY 0x92 

#d«fin« SFTSPCKEY 0x93 

«d«fine AOVTEXT 0x94 

•define ESQ(EY 0x95 

#deflne 8ACKTEXT 0x96 

#define KANASPACB 0x97 

#define SELECTKEY 0x98 

tfdefin* TA8KEY 0x99 


/* 

/* 

/• 

/* 

/* 

/• 

/* 

/* 

/* 

/* 

/* 

/* 

/* 


/* 

/* 

/* 

/* 

/* 

/* 

/* 

/• 

/* 

/* 


レンジ«択状®に入る•終了する（トグル） •/ 
レンジ进択状雄に入る •/ 

レンジ*択«戆を終了する•/ 

办ーソル 位 -K の1文字をレンジ«択する •〆 
々■■ソル位！!！の1単語をレンジ選択する*/ 

々ーソル位 K の1行をレンジ*択する*/ 

々ーソル位茜の 1 ¢ をレンジ进択する*/ 

レンジ迸択？れているテキストを切りとる*/ 
レンジ道択されているテキストを供写する V 
力ーソル位 E にペーストパッフ r ■を貼る*/ 

力ーソルの表示座標を cursorPtr に合■わせる*/ 
dispTopLine に合わせて画面を S き®;し，*/ 

冷ーソルが画面外に出たと i には正する •/ 


リターンキ ー*/ 

•✓フトキー ♦ リターンキー*/ 

スペースキ ー*/ 
z フト*スペースキー*/ 

対象テキストを進める （TA8 キーと阏じ）*/ 
ESC キ ー*/ 

対象テキストを戾す 》✓ 

カナシフト状班のスぺ_スキ—*/ 

SELECT キ ー*/ 
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P 能コ ードがマッピングされているキーの獲得 

I 梭能#号 288 

| S - 式 TINY getali ^ ikey ( funccode ) 

TlHif funccods [ A ] 棟能コ—ド 

| 55リ tfl , [ A ] t ： ット〇〜 6 に英数字妃号の ASCII コード 

ビット7に ICTKLl キーの状® (0=柙ドなし、1■押下あ 

% I funccode で指定した編集榷能が、どのキーに別り付けられているかを 

18します* 

機能コード の獲得 

|壤能番争| 289 

_ 5«tj tey/Uwc ( even *) 

1 S 式 1 TINY . getjekyfunc ( event ) 

EVENT *event [ HL ] イベント構造体へのポインタ 

[* ') «] tA] 檐能：!ード 

[_» 说| かな«字*换中のキーイペン！•に対 fc する檐姥コードを返します。 

キーマップの設定 

[機 S 号] 291 

I S 式 void -8 etkeymap ( table ) 

' - 1 char *table [ HL ] キ—マップテープルへのポインタ 

[«')*] なし 

[解说丨 キーマップを table で指定したように没定します。 



キーマップの獲得 



PCM の再生 


逆能 s 

I » 式 I 

I m り w I 


368 

STATUS -pcmplay(pcm) 

PCM *pcm [HL] PCH® 造体へのポインタ 

[A] OK M 後まで正 « に生できたとき 

ERROR 圈 I '[； [3TOP| キーが押され.き 


解 ISL FCM の再牛をします。 pcm には、 PCM 構®体へのポインタを指定し 

ます • 再生途中に ISTOPl キーが押されたときは. ERROR が返’）ます， 
正しく S 後まで再生できたときは， 0K が返ります。どちらの場合でも、 
fe 後に再生された次のアドレスが PCM «造体の start に.残りの ft さが 
lengtli に返されます，フラグは壊されます。 


PCM の録音 


榷能垂号| 3C9 


| 存式 | STATUS pcDrec(pcn) 

PCM * P cd CHL] PCH 稱 ft 体へのポインタ 

[戻り値 j [A] OK Ai 後まで正常に録音できたとき 

ERROR 銶音途中に [STOPl キーが押されたとき 

[解说] PCM の錄音をします。 pcml：：(iPCM 供违体へのポインタを指定しま 

す，録斉する領域、錄音两波数などの PCM 稱造体は、 -pcmpl 町と間じ 
です。 »音途中に1112キ•■が押されたときは、 ERROR が返ります， 
正しく «後まで！*音できたときは、 OK が返ります。どちらの場合でも 



21.2 フアンクシ b ンの說明 




メモリマネージャの初期化 


[tt # "-] 3*3 

char *_endap [HL] アプリケーシヨンの®終アドレス 

[戻り紙 1 なし 

[解说| _maMoc()、free()、_sbrk() のメモリマネージャ7ァンクシ s ンを使用 

するときは、このフ T ンクシ3ンを:!ールしてメモリマネージャを初期化 
して下さい • 


データ領域の大きさの変更 



メモリプロックの解放 


「檐能番号； 305 

I 害式 void free(block) 

char *block [KL] メモりブロックへのボインタ 


なし 

[解 JJI 丨 umllocO で推得したメモリプロックを解放します， 


メモリブロックの獲得 


[S? tt j 


char *jsalloc(block) 

int block 【HL] プロックサイズ 

[HL] メモリブ〇ックへのポインタ 

梅定された S のメモりが®得できなかった塌合には-1 

block で播定したパイト»のメモりブロックを铟リ当て.そのプロック 
へのポインタを返します • 


VRAM バッファのオープン 
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VRAM バッファのクローズ 

[檐能—*号 J 3 ,0 

_ 售 _式」 void .closevb(void) 

[«'；«] なし 

[W ；)l I VRAM パッフ■クローズします。 


VRAM バッファ への書き込み 


[H 能* 号 1391 


厂》式 I 


char .src [HL] "メインメモリ上のアドレス 

char *dst [DE] VRAM バッファの光通からの才7セット 

unsigned n [BC] #$込むパイト数 


K リ値 I [HL] VRAM バッフ7•に*き込まれたパイト数 
8•き込みに失敗した場合0 


[ 髀我I メイン RAM 上のデータを VRAM へ転送します • src に転送元のメイ 

ンメモリ上の先頭アドレスを、 dst に VRAM パ-/7 7•の先頭からの才7 
セットを、 n に転送するサイズを指$します。 



VRAM バッファからの読み出し 


「拽能 # 392 




char *src [HL] VRAH バッファの先 g 

char »dst [OE] iffi み込み先メインメ 

unsigned n [BC] 號み込むパイト& 


|圾リ娥| [HL] メインメモリ上に班み込まれたパイト数 

班み込みに失敗した場合 •(） 


[W 3t 1 


VRAMi： のデ_夕をメイン HAM へします。 


べッフ7•の光*からの才7セット. dst に忒み込み: 
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21.2.6 プリントマネージャ 

プリントマネージャは、プリンタ出力を资押-するマネージャです • ブリンタマネー•ンャは、 
指定されたデータをプリンタドライパに渡し、プリンタドライパが、本体に接統されている 
ブリンタし iet たプリンタ®]»コマンドをプリンタに送ります。 

21.2.7 プリンタドライパ 

プリンタドライバと«、ブリンタとアブリケーシ3ンの明に人 1 J、 どのようなプリンタが 
接校されているかを、アブリケーシ3ンが®*しなくても印剿で S るよう K するためのオー 
パーレイブログラムです。 

プりンタドライバはプリンタごとに月され、ユーザーが r ブ i| ンタ .DAj を使用して 
接級されたブリンタ W のドライパを》定します， 

アプリケーシ s ンが pd() を突行すると、说在 a 定されているブリンタト•ライパが呼び出 
されるので、どのプリンタが接統されているか（どのプリンタドライバが狡定されているか） 
をアプリケーン》ンは sa しないで印刷することができます。 

21.2.8 プリンタドライパの変更 

chpd<) により、アブリケーン * ンプログラムから、どのプリンタドライパを使川するか 
を投定できます。しかし、通常は「プリンタ .DAj によってユーザ■が»：定するので、むや 
みにしてはいけません • 

21.2.9 プリンタドライパの呼び出し 
プリンタドライパを呼び出すには J)d() を他います • _pd() には檐能 S 号を彼して、どの 
ような!<!»をするかを指定します。樣能番号とその内容は U 下のとお 1 J です。 

表3.35ブりンタドライパの棣陡#号 


m 

内容 

0 PDJNIT 

ブリンタドライパの初朗化 

I PD.OPEN 

プリンタの印期期始宣 S 

2 PD.CLOSE 

プリンタの印刷柊了苕 S 

3 PDJ»RL\T 

印明の龙行 

4 PD31ENU 

用紙の没:£ 

5 PDJiTART 

開始ページ終/■ページ卬«枚»の设定 

6 PD_PAGE 

印刷閉始メッセージの表示 


21.2 フアンクシ s ンの说明 
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アプリケーレ a ンは KtT の f で印 M します。 

1. PDJNIT でプリンタドライパを初期化します。 

2. PD.MENU で用紙を汶定します。 

PD.MENU ではプリンタドライパがダイアログを表ボし、ユーザーの:»定を ii! 世し 
ます，用#の;*定は、アブリケ_シ3ンのメニューで卬明の前に行なってもかまいま 
せん， 

3. PD-START で開始ページ，終了ページ、印 Sij 枚数を汶定します。 

PDJV1ENU では、ブりンタドライパがダイア〇グを*示し' ユーザーの»定を Sdit し 
ます。 

4. PD.PAGE で用紙セットのメッセージを衣示します。 

5. PD.OPEN で印 W の開始を宜宫します- 
S. PDJRINT で印刷を実行します。 


印刷開始ページや終了べージ、印刷枚 ft などはアプリケーションが- printinfo() を呼び 
出して PRIXTNSjS 体へのポインタを取得し、栴造体内部の Startp、endp. copy を凋 
ベて決定します。擤 S 体内部の opt の* 4T 位ビットがIのときは、カット紙の a 定に 
なっているので，アブリケー vs ン {Jtl ページ印脚す4ことに、 PD-PAGE を呼び出 
して用紙のセットの*示をしなくてはなりません， 

7. PD.CLOSE で卬明の終了を SS します- 


プリンタドヲイパの機臃 

プリンタドライパの各櫬能について、 UT で说明します。 

表 3.36 プリンタドライハ•の榷能 


名前 梅能 

PDJNIT ブリンタト•ライバを初期化します • MSXView ネル内®にある 

プリンタ用の7_クエリアを、プリンタドライバが持っているで 
初期化します。 4>d() は正しく初期化できた場合 OK を、初期化で 
S なかった場合 0K 以外を返します。 

PD.OPEN I印刷の開始を宣 g します。プリンタをリセットし、印刷ができる状 

態にします。 -pd() は印刷が可能になったら 0K を返します-プリ 
ンタ*<«较されていなかったり、ブリンタがオンラインでなかった 
り、用 tt がなかったりしたら、 OK 以外を S します • 

PD-CLOSE 印刷の終了を宣言しま十。 .pd() は正しく終了できた場合■に OK を> 

終了できなかった場介 0K 以外を返します • 



ii 拽能 

PDJ>R1N'T 印刷を行ないます， PRINT 橡造体の buff で示されるバッファの内 

斿を解釈し、プリンタの制钾コードに変«してプリンタに送ります， 
liuff は、通常は MAIL を示しています， MAIL は 080H-0PFH * 
地までの128パイトしかないので、アプリケーシ3ンがもっと多く 
のデータを- -S に印明したいときは*史することができます。芘史 
するときは、 buff の示す番地がプリンタドライパと M ならないよう 
に-卜分大きくなければなリません。変 g した t きは、印刷が持了し 
たら buff が MAIL を示すように庚して下さい， 

データの終わりは 00H をおきます。 

印劇中に1 GRAPH 1 + [STOP I か押されると、印刷を中断してアプ 

リケーシ3ンに员ります。 



21.2 フアンクシヨンの说明 
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名前_楼鹿 _ _ 

PD.START 阳始ベージ.終了ページ.印刷枚数を設定します。プリンタドライ 

パがダイアログを表示し、ユーザーの設定を ■pn—ntinfoO が返す構 
造体へのポインタで示される領域に JC® します。 

K 定？れる值 （PRINT 構造体内は iUT のとおりです。 

稱造体のメンバ总》农 
startp 明始ページ 

〇 Ai 初のページから 

それ以外そのページから 



〇 最後のぺージまで 

それ以外そのページまで 
印 W 枚数 

〇 1枚のみ 

それ以外その枚数 


p«i() は、狡定されたら0を、中止されたら1を返します • 
PDJAGE 用紙セットのメッセージを表示します • プリンタドライパは 

1 ■用紙をセットして RET キーを押して F5 い j 
IH.BU t a ■■-.キーが押 lr，| || Hl!l.w ir ^ 

が押されたら0を， IESCI キーが押されたら0以外を返します。 
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プ IJ ンタ制御コマンド 

プリンタドライパが解釈する制 W コマンドは、以下のとおりです，大文字はその記号、小文 
字はバラメータを表します。 ESC は 01BH, CR は ODH. LF « OFH. FF « OCH です。 

*3.37プリンタ制 W コマンド ー*£ 



ESC R 


.£ 味 

7リンタのりセット 


プリンタをリセットします， 

ESC V h v グラフィック印刷の大率の»定 

画面のグラフィ•/ク印刷を rr なつときの拡大率を as します，横拡 
大4!は h で，播拡大_はVで a 定します，どちらも1パイトで报 
定し . 1を3：定すると尚面上の1ドットがプリンタ上での1ドット 
となり、2を a 定すると两而上の1ドットがプリンタでの2ドッ 
卜となりま1% 

ESCFf グラフィック印«の左マージンの »S 

幽面のグラフィック印 W を行なうときの左マージンを»定します • f 
は 1 7— ドで指定し、左雉からのブリンタでのドット数となります。 
ESCJj 紙送 1 )の実行 

紙送りを芙行します》 j はワート•でブリンタでのドット数となります。 
ESC ! n areal area2 area3 ••• arean 

幽面のグラフィ y ク印刷 

画面のグラフィック印刷を行ないます。幽面上のいくつかの範囲を 
—度に印刷できます。 n はバイトでその後に嫌く画面の傾域の個数 
を指定します。 areal から arean は AREA 構造体で印刷を行なう 
領域を指定します。幽两上でパレット 3 _ドが1の画索がブリンタ 
で黑として印刷されます。 

ESC I pattern アイコンパターンの印刷 

12xW ドットの 7* イコンを印刷します。 pattern は、18パイトのピッ 
トバタ-ンデータそのものを指定します。 

ESCKxy テキスト印字の文字サイズの报定 

テキスト印字での，文字のサイズを抱定します- 3C はパイトて•樵の 
サイズを、 y はパイトで播ののサイズを指定します。文字サイズの 
初期値は 24x24 です。 

ESCPp テキスト印字の文字の横の間隔の指定 

テキスト印字の文字の横の問痛を指定します • p はパイトです。文 
字ビッチの初期®は1です。 
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コマ✓ド 意味 

escx アンダ'-ラインテキスト印字の a 定 

アンダーラインテキスト印字をします • これ ESC Y が送 
られて解除されるまでのテキスト印字 U, アンダーラインつきで行 
われます，アンダ_ライン印字は、1行の印字が終了しても、 W 除 
されません， 

ESCY アンダーラインテキスト印字の解除 

ESCX で設定されたアンダーライン印字を解除します，初期化時 
は、このモート•になります • 

ESCx プ〇ポーシ3ナル印卞の解除 

プロボーシ9ナル印字を解除します，これ以降、テキスト印字は固 
定ビ，チで印字されます • 

ESCy プロボーシ*ナル印字の»定 

ブ〇ボーシ 3 ナル印卞を設定します。これ以择、テキスト印字はブ 
ロボーシヨナル印字 S れます。初期化時は、このモ_ドになります。 

CR キャリッジリターン 

プリンタのパッフ7■にあるデータを印刷し，ブ y ンタへッドを左端 
に戻します • 

LF ラインフイード 

プリンタのバッファにあるデータを印刷し、用紙を1行分送ります。 

FF フォームフイード 

プリンタのノ<ッファにあるデータを印刷し、用紙を j ページ分送り 
ます， 

00H 印刷データの終わ！） 

印刷データの終了を S 味します。プリンタドライパはこのデ_夕を 
»むと、アプリケーシ a ンブ〇グラムに返ります • 


上纪コマンド以外の文字が ESC の後に枝くと、ブリンタドライパはその ESC および次 
の文字を無視して、更にその次の文字から解釈を実行します， 

上纪プリンタ制御コマンド以外はテキスト印字として极われます。灌字3— ドは•〆フト 
JIS コードです，テキスト印字で，薄字を印字できないプリンタでは、プリンタドライパが 
MSXView の持ってぃる漢字フォントを«閉して、ビットイ〆ージで印字します^灌字プリ 
ンタでは、プリンタドライパがブりンタに合わせて、溪卞 3- ドを変換して送9ます. 



プリントマネージャの初期化 


I 被能岙砖 ； 311 

[R 0 fill"] なし 

I解；！I丨 プリントマネージャを初期化します。このフ7■ンクシ8ンはシステムが 

n 勒的に尖行するので，アプリヶ ーys ンから* t び川す必要はありません。 

プリンタドライバの変更 

L 梭 能*司 312 

| 方式 | STATUS chpd(drivar) 

char »drivar [HL] プリンタドライバ名へのポインタ 

[戾リ 依"！ [A] 0K 変疋成功 

ERROR 4® 失敗 

「解；说 I プリンタドライバを <Wv« で携定したものに <tK します， 

プリント情報の獲得 



212 フ r ンクシヨンの説明 625 

プリンタドライバの起動 __ 

[機能番号 __ 314 

[ # 式] int .pd(func) 

WORD func [HL] S « . ■番哥 

[R [HL] エラーが起こったら -1 

[解说 I ブリンタドライバを *S 抑し， func で衍定されたブリント 77 ■ンクシ 3 

ンを実行し ます。 
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才^ノーレイの使い方 


オーパーレイを使用するには，以下の2つの方法があります • 


• _8>81«»()を用い、外部フ7•イルのオーパーレイモジュールを呼び出す方法 

• _execute() を用いて、アブリケーシ a ンのフアイルに結合された才ーパーレイモジュー 
ノレを呼び出す方法 


---*1的に、前者はシステムで共通に使用するオーパーレイモジュールの呼び出し1こ使用し， 
後者はアブリケーシ3ンが個別に使用するオーバーレイモジュールの呼び出しに使用します。 

前者の代表例としては，ファイル名を選択するための iTILEPACKMVj や、フォントメ 
ニューを表示して7ォントを選択させる 「FONTMENU, MVj などがあります。 

後者+の -executeO を用いた オー パーレイモジュール11、個々のアブリケーシ * ンが使用す 
る#用才ーパーレイモジ*ールの場合に使用します。この方法では、 オー パーレイモジュー 
ルも含めて、 アブリケ_シ■ンが1っのフ7■イルになるため、アブリケージ s ンの取り©い 
(バックアッブなど）が容©になるという利点があります。 

オーパーレイモジュールは、010 OH からモジュールサイズだけ住み込まれます*才ーバー 
レイモジュー ルの 後み込みアドレスの指定はできません。 したがって、才■パーレイモジュー 
ルがアクセスするデータや才ーパーレイモジュールが利用するル_チン群は，メモリの K 位 
アドレスに*かなければなりません，この除に、オーバーレイモジュ_ルにより上畜きされ 
てしまうメモリの内容は、 MSXView が自»的に逍遘するので、アブリケーシヨン側では退« 
に関する作業は何もする必ではありません。また、ディスク上の空き容 a の許す限り、オー 
パ_レイ呼び出しを多廑に行なっこともできます， 

オー パーレイモジュールが授み込まれると、 M 籴件に010 0H がコールされます。したがっ 
て、才 一/< ーレイモジュールの先頭には、必ず才ーパーレイモジュールの main 関数へのジヤ 
ンプ命令を掸入しておかなければな9ません • さらに. MSXView では、このときに2っの 
51数を；*すことができます。1っめの引数を char*、 2っめの引数を int と仮定しているので 
呼び出されるモジュールは、 main(char *parameterl,mt parameter2) で受けるようにしま 
t. これ以外の型の引数が必要であれば，キャストして下さい。また，構造体などを引き》 
すには，その構造体へのポインタを被すのが一般的ですが、構造体のデータ格納アドレスが 
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オーパーレイモジュールによって上眘きされてしまう可能性があるので，注意して下さい， 
このため、 MSXView では、 080H 番地からの128パイト （MSX DOS2 で使用されているデ 
フォルト DMA バッファ）を MAIL という名前で予約し、アブリケーシ s ンが自由に使用で 
きるようにしています • 

また、 _executc(} で、アブリケーシ 3 ンファイルに結合されたオーパ'-レイモジュールを 
呼び出すときは、アブリケーシ a ンフ T イルをカレントフ7•イルにしておかなければなリま 
せん，このための f •枝きは，以下のようにします。 

HAMDLE myfd, /* アブリケ—シ a ンファイルのハンドル宣言*/ 

myfd - _fopen(MYMAME, NEW); /* アブリケーシ3ン77■イルをオープン*/ 
_chfile(myfd); /* :&レントファイルにする •/ 

この手統きのあと、他の7ァイルをアクセスする除には， —pushflleO と 4>opfile<} を使用 
し、 -execute() を実行する除には、泠レント 7r イルがアプリケーシ s ン7ァイルになって 
いるように注空して下さい， 

また、オーパーレイモジ 1- ルでは戾〇锇を返さないので，オーバーレイモジュールから 
の戻リ値が必要なときは、 jnoduIevahieO を使用して、戻り値を得て下さい，ここで返す型 
は WORD なので.構 SS 体などを返すときは， MAIL を使用することができます- 

咩しくは、16章•■リソースマネージャ j の，を麥照して下さい • 





MSX-MIDI とは 


2 章 

ハードウェア 






» 2«ハードウ: t ■ア 


2.2 内蔵 MIDI インターフェイス 

本体に内葳された MSX MIDI インタ'ーフェイスの1/0ボートは，次のよつに M 1 ) 当てら 
れています。 

• 8251インタ—フ i イス OERH. 0E9H 番地 

b7 b6 b5 b4 b3 b2 bl bO 
0E8H (Road) I RXD7lRXD«[RXD5| RXD4lRXD3[RXD2)RXDll RXDo] 

(Write) ITXD7lTXD6[TXD5lfxD4jTXD3[TXD2)TXDlljxDql 

RXD7-RXD0 8251 データ 

TXD7-TXD0 8251S 倍データ 






2.2 内* MIDI インターフ x イス 
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SBRK 通常0に: K 定します 

RE MIDI IN 受6イネー7•ル （1=許巧、0=桀止） 

TIE 8253タイマー（カウンタ#2> (1 二許可，0=禁止> 

M り込み許吋 

I-E.N MUMOUTSM イネ-7•ル (1=« : »J, 0=Sjh) 

8251のコマンド•モードレジスタの有き込み回嫩問は、最大16クロック (3.579545MHz 
) 必要です。8251の初期イ匕など、逹嫌してコマンド.モードレジスタに S き込みをす 
る際は、ウェイトを入れて下さい， 

8251は I/O ポートの 0E9H に 00H. 00H, 00H、40H を#き込むと、リセットされま 
す。そードに淇つた価を設定すると， MIDI として機能しなくなるので、リセット後は 
必ず1$定の値を設定します- R 細は，添付のサンプルプログラム （「TIIRU^MACj) を 
参照して下 S い， 

• 82530 UT2 瑞子の®号のラッチ (OEAH. 0EBH# 地） 

b7 b6 b5 b4 b3 b2 bl bO 
OEAH (Wnte) f - f - f- f~ f~ 厂一 l^l 一 1 

OEAH 番地のデータリードは無効 
OEBH 番地は OEAH 番地のイメージ 

8253のカウンタ#2からの W リ込みは、 OEAH 番地への住 S のデータ卉き込みによつ 
て解除されます。 

• 8253インターフェイス <OECH~OEFHS 地） 


b7 b6 b5 b4 b3 b2 bl bO^ 
'Tn7 rmfil rm<; ffTrui rms fr Tn^l rmi irmnl 
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CT07-CT00 # ウンタ#〇 

CT17~CT10 カウンタ#1 

CT27-CT20 カウンタ#2 

SCI、SCO カウンタ*択、コマンド进択 

RW1.RW0 カウンタリードライトモード 

M2. M U M0 カウンタモード 

BCD パイチリ、 BCD カウント遘択 

各；9ウンタの機能 li 次のようになっています。 

-カウンタ#0 

8251のポーレートジ t ネレ—夕として使われます。 CLKJS 子には 4MHz のクロッ 
ク價号が入力 S れています。8251に対しては，ボーレートクロックとして 5_0KHz 
を送價する （8 分商する）ように改定しなければなりません。モード IJ3 ( 方形波 
N 分周モ_ド〉で使用します ■> 

ー カウンタ#1 

汎用のカウンタとして使うことができます， CLK «子にはカウンタ#2の fh 力が 
入力されています。 

-カウンタ#2 

CPU への周期的な割り込みに使用されます （BASIC では5ミリ秒 IfflPlS の割り込 
みとして便用される）。通常、モード2 (JV 分周モード）で使用します。 OUT2 端 
子が LOW になると、ラッチ面路を通して CPU に刺り込みを発生します。 CLK 
«子には 4MHz のクロックが入力されます。 

2.3 外付け MIDI インターフェイス 

外付けの MSX-MIDI インタ—フェイスは、 I/O ボ - I•の 0E2H に値を狭定することによっ 
て、 I/O ポートのアドレスが変わります。 

• MIDI インタ—フェイスの a 定 （0E2H、0EAH 番地） 

b7 b6 b5 b4 b3 b2 bl bO 
0E2H (Write) I EN l"— [ — ] — f — [ — ] — l"E8~| 

EN MIDI インターフェイスの使用許可、禁止（〇=許可、1=禁止） 

初期値は U 

E8 8251アドレス»定 （1=0E0H、0E1H* 地） 

初期値は1。 (0=0E8H. 0E9H 番地） 

E8 ビットを0に設定すると、外付け力ートリッジの MIDI インター7ェイXの I/O 
ボートは、 0E2H から 0I5AH に変わり，内蔵 MIDI インターフ x イスとコンパチ7•ル 




2.3 外付け MIDI インターフ * イス 
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にな0ます。また、8251の I/O アドレスは^ 0E8H と 0E9H になります。 

E8 ビットを1に說定すると、8251インター 7* イスは OEOH、0E1H 番 JlfeL なり 
カートI)ツジの I/O の OECH-OEFH へのアクセスは费止されます-また、8253の夕 
イマー割リ込みも费止されます。 

• 8251インターフェイス <OEOH、OEIH^S 地） 

(E8 ビツトが1の場合） 

■ b6 b5 b4_ b3 b2_ bl bO 
OIXIII (Read) [R>J^7|R XD6]RXD5fRXD*| RXD3[RXD2I RXD iJrXDoI 

(Write) [T>^7 IjXD 6 ItXD 5ITXD4] tXD 3[ tXD 2 ITXDiItXD 01 








内蔵タイプと外付けタイプとの見分け方 



MIDI インターフェイスの有無の判別方法 



割り込み 



4 章 


アブ) ) ケーションの 開発 


4.1 アプリケーション開発についての注意点 

MSX-MIDI 対応のアブリケーシ a ンブログラムを作*すると S Iも UI 下の点に注«して 
下さい. 

1. フックは MSX-MIDI が本体に内蔵されているか、外付けされているかで興なります。 
フックを投定する探は、内蔵タイブか外付けタイプかを確*2して下？い， 

2. MIDI インターフ x イス初期化後などに割り込みを許可するときは、すでに割り込みフ 
ラグがセットされている可能性があるので、剂〇込みフラグをリセットしなければな 
りません， 

割り込みフラグには、以下ものがあります。 


表 4.4 MIDI インターフ*イスの割り込みフラグ 








サンプルプログラム 



拡張 BASIC 


5.1 拡張 BASIC の概要 

MSX MIDI には、各機能を*単に使用できるように、 MSX-MIDI1£*BASIC が用*さ 
れています， MSX-MIDI 拡强 BASIC は、 CALL MUSIC のように拡張ステートメントの形 
式になっています。 CALL は、.（アンダーノ で代用でき it。 

MSX-.MIDI 拡强 BASIC では. MIDI インターフ1イスを通じて外部の MIDI 楦器を使用 
することができます。そのため、コマンドが追加*変更されました • また、 MML も MIDI 
に対応するため拡張変更されました， 

5.2 拡張 BASIC の解説 


CALL MUSIC 


| 機能] MSX MIDI システムを初期化し*す • 

「 * 式1 CALL MUSIC 【([くモード >M,[0] [,<PLAY 文第1文字列へのチャンネル数 
> [，く PLAY 文第2文字列へのチャンネルレ[，く PLAY 文第9文字列 
へのチャンネル数.]1]]]酬 )1 

[解说丨 内* FM 音源 LSI の初期化. FM 音®のチャンネルをどのように使用す 

るかの播定、 MIDI インターフェイスの初期化を行います。 CALLMUSIC 
文はよ!)初期化するまでは、拡張 BASIC ステートメントを使うことはで 
きません， 

• <モード> 

指定するのは0か1で，以下のような意味がありま t。 
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指定怠味 

0 リズム ff を使用しない 

1 リズム音を使用する 


チャンネル数 

それぞれのモードで、使用できるチャンネル数は次のとおりです。 
モ ーP リズム 最大チャンネル数 

0 無し 9 

1 有9 内蔵 FM (6裔+1リズム） 

MIDI (8 音+1リズム> 


そード1では、 MIDI を使うとき U 使用できるチャンネル R が，8チヤ 
ンネルまで增えました。 

PLAY 文の各文字列へのチャンネル数は、内蔵 FM 音源が使用し、そ 
の文字列がいくつの OPLL のチャンネルを占有するか指定します，0 
は播定できません， 

OPLL のチャンネルは9までしかありません。また、モード1で U リ 
ズム音用に3チャンネル使います，したがって、モード0で IS PLAY 
文の备文字列へのチャンネル数の合 IM •は9以下、モード1では6以下 
でなければな0ません。 

MIDI の場合は、各文字列に対して MIDI チャンネルを1つ割り当て 
ます，2以上の镣を指定しても«味は変わりません。 

FM 音源のチャンネルは、チャンネルの/1、さい方から割0当てます。 
MIDI チャンネルは第1文字列から顺に、1, 2、3 •••と狡定5れま 
す，これを変更するには、 MML の® Hn コマンドを使用します。 
パラメータを1つ以上报定した場合、他のパラメータの省略時の tt は 
0になります。 

PLAY 文の各文字列へのチャンネル数は、0に R 定した!)、«略した 
0することはできませんが、 一SB 例外があります。次の例を参照して 
下さい. 

CALL MUSIC(0,0,0,6,0) 

T T 

0 を設定してはいけない (Illegal function call になる） 

CALL K0SIC(0,0,1,,2) 

t 

省咯してはいけない （Syntax error になる> 




5.2 拡張 BASIC の解説 
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CALL M0SIC(1, 0,1,1,1,1,1, 1,0,0) 

T T 

モード 1 の第 7 文字列、第8文字列に対してのみ0を定できる。 i 
の時、 PLAY 文では次のようになる。 

- PLAY #1の場合 

第1文字列一第8文字列は MIDI に剌リ当てる。 

第9文字列は MIDI のリズム音に M 0 S てる， 

第10文字列〜第12文字列は PSG に割り S てる。 

PLAY #2の場合 

第1文字列-第6文字列は内蔵 FM 音源に別り当てる。 

第7 文字列と第8文字列とは無視される。 

第9文字列は内蔵 FM 苷 K のリズム音に®)り ft てる。 

第10文字列~第12文字列は PSG に M リ当てる， 

ラメータなしで使われたときは， 

CALLMDSIC(1,0,1,1,1) 

と闻じになります。 

CALL MUSIC 文を实行すると、システムの別り込みの7ックが MSX 
MIDI の•ノステムソフトウェアにリンクされるので、割り込み理ルー 
チンの才ーパーへッドが》譫え、システムのスループットが f 氐下します • 
また， CALL MUSIC 文は 1 7-クエリア確保のために、内部で CLEAR 
文に相当することを行っているので、 HIMEM (CLEAR 文の第2パ 
ラメータに相当します）が807パイト小さく再校:定され、変数はすべ 
てクリア？れます。 

[_ 文例 | CALL MUSIC 

デフォルトの K： 定をする， 

CALL MUSIC(0, 0,1,1,1, 1.1, 1.1.1. 1 ) 

1チャンネルずつ PLAY 文の文字列に刺り当てる。 


CALL MDR _ 

[檐能I リズム音用 MML で発音される MIDI/- 卜番号を设定します。 

「謇式| CALL MDR (く B の MIDI ノート番号〉，く S の MIDI ノート番号〉, <M の 
MIDI ノート «号;>, <C の MIDI ノート番号;*, <H の MIDI ノート番号〉） 


[解说I リズム音用 MML で使用する B、S、M、C、H コマンドに別り当てる 

MIDI ノート番号を指定します。 
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MIDI 音源の多くは、1つのチャンネルの备ノ -- 卜にリズム咨を割り当て 
る機能（リズム#用トラック）を持っています。 PLAY ■文の各文字列は 
1つのチャンネルにしか対応していません • 同時に枚数 S •を発菝するリズ 
ム音の場合は，この y ズム専用トラックを使用するようにして下さい。 
このリズム音の刻〇当ては、各] VIIDI 梭 S によって異なります。お手持ち 
の MIDI 機 S のマニュアルを参考に铺りN5てて下さい。 

パラメ'-夕は 0-127 を指定します。省略はできません，初期値はすべて0 
に胶定されています,， 

[文例 I CALLMDR(3S,38.45,49,42) 

PLAY 

[檐能 | 音楽を MML にしたがって済奔します， 

[ff 式 I PLAY|#< モート* >,]< 文字列1>|,<文字 W2> 【,<文字列3：►.•.[，く文字列 
13>] 

「»说 PLAY 文は音*を演奏する fc ので、内蔵疰) + PSG-& 源 （3 
音)、または MIDI 檐 S(9 音) +PSG 音源 （3 音）の、•大12音まで同時* 
可能です。<文字 W> に香かれた MML にしたがって i 寅#します， 

他の拡*命令と死なり、 CALL 文は必55ありません， 

<モー h-XiO-3 までの IS をとり、 PLAY 文の音®や助作モードを次のよ 
うに狡定します。 

• 0や'15略されたときは PSG のみが音朦とな0、文字列は最大3つま 
でとなります。 

• 1のとき、 MIDI 梭器、 PSG 音»を使用できます。 

<文字用 > との B8 係は始めから*に 

<MIDI 嫌 SS 用文字列梭5用文字列 n>, 

<MIDI 梭 S リズム ff 用文字列>， 

<PSG 音源用文字列 1>,<PSG 音用文字列 2>,<PSG 音 
通用文字列3> 

となります。 

• 2 または3のとき、 FM 音港. PSG 音*を使用できます （2 のときと 
3のときとでは助作は间じ.) • 

<文字列>との明係は初めから顒に 

<内葳 FM 音源用文字湃内蔵 FM 音®用文字列 n>, 

<内蔵 FM 音源リズム音用文字列> 

<PSG 音®用文字列 1>,<PSG 音源用文字列 2>,<PSG 音 
* 用文字列3> 



5.2 拡張 BASIC の解説 




となります。 

n は CALL MUSIC 文で»定された MML の俪》です。 CALI- MUSIC 
でリズム音を使用しないモードに a 定した*合は、リズム音用文字列を力 
ンマ （,） と共に省略しなければいけません。 

[文例"] PLAY#1，”CD”,”EP，”GA” 


MIDI 機器用 MML の仕様 

ここでは、 MIDI 棣器用に追加および突 E された MML を説明します。 


裘4ぷ MIDI 棰器用に追加された MML 

文字 «味 値の範囲 

®Hn fft 用する MIDI チャンネル番号•を級:定します。 lSnS16 

@Cm,n コント〇—ルチ i ンジを出力します。 0£m£127 

m はコント n— ル®号， n はコント d —ル番号に対する设です。 〇 £ n £127 
OSn MIDI リアルタイムクロックに関する命令です。 

n=0 FCH(STOP) を出力し，クロックを停止する 
n=lFAH(START) を出力し、クロック出力を明始する 
n=2FBH(CONTINUE) を出力し、クロック出力を開始する 
ク〇ックのテンポは、 PLAY 文の第1文字列と同じになり 
ます。 


文字 

~nr~ 

Rn 

frlVn 

Vn 

@Vn 

@n 

Zn 


表 4.6 MIDI 梭器用に変更された MML 
S 味 械の _ 

tt さを设定します。 lSnS96 

休符を«定します。 lSnS96 

n で指定した ft? だけ状®を椹技します。 lSnS96 

MIDI 株 SliM しては、8倍した倣をノートオン•ベロシティ- lSnS15 
として出力します。 

ボリューム（コント〇— ルチェンジ#7> を出力します • lSnS127 

内蔵 FM S® に対しては音色変 E を出力しますが， 0SnS63 

MIDI 梭 S に対してはプログラムチェンジを出力します。 〇 S n S 127 

1，<イ h MIDI データを出力します。 1 g ng 255 
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”ズム音用 MML の仕様 

ここでは，リズム音用に追 JB および変更3れた MML を18明します。 

表 4.7 リズム苷用に追加3れた MML 

文字 $. 味 

@11 Mim 棰 S に対してプ〇グラムチ X ンジを出力します。内蔵 FMff 源では無視さ 

れます。 


表 4.8 U ズム9用に変疋された MML 

文字意味 

®An に対しては、 Vn と K 找にべロシティーを定します。 



5 2 拡張 BASIC の解说 
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^uooo - 00000000000000 X 


.3127 

一一 ^ 

0 00000000000000000 0 00 - 〇 _ 


271271027 | 55]1 

ニ ニ ニ 

S.2. rt-to. pto. 


00000000000000000000000 -oo 


一 Mn snvn LnononVATn r' A-G' # ?{}n l I r irl 


^0 



MIDI 機器に対して無効なステートメント 



MIDI データフォ 
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4. システムリアルタイムメッセージ 


クイミングクロ7ク 
ステータス 11111000 (F8H) 

タイ S ングクロックは， 6S1 または® S2 でク〇ックが明始されていて、かつ 
PLAY 文が実行されているときにのみ送信されます， PLAY 文を終了すると、 
クロックは序止しますこの時、ストッブ FCH は出力されません。 

®S1 スタート 

ステータス 11111010 (FAH) 

クロックの出力を明始します， 

®S2 コンテイニ •》_ 

ステータス limOll(FBH) 

クロックの出力を两始します， 

@so ストッブ 

Xテータス 11111100 (FCH) 

クロックの出力を停止します。 


5.4.2 受信 


拡張 BASIC では受信は行いません， 








R 800 インストラクション表 


UI •- III ll.f 

ix lil| .ix 


V ,7.9-„ <7)h r .TT-.t , h _ 

I レノスク --a のビ / 卜 U7 
■ のド yj り 

1.(1. Hi K / 卜« 16 ビ / I •が 111 に人る. 32ビ / 卜铲& 

(こビ/1•の fjy つ S 突位を足した Ift が， J •、すアドレス 
|キャリ ー7 ラグ 
|ゼ〇7ラグ 

パリティー，才ーパー 7D-7 ラグ 
サイ >7ラグ 
MW フラグ 
ハー7キャリーフラグ 
フラグは変化しない 
フラグは•欠 M. 1 ,* により«化する 
Vラグは0 
•77 Tit I 
小逡になる 

t-<<--7o-777t Lttt われ厶 
•J ?■ - - 7 7 7 t し Ttt われ 6 
« り *iA7 リ，プフ〇 7 ブの 1 * が人る 
ジ a ター . * J> r..<l.f. Ii 1 
|k ビ 》|• レ - ン * 夕 — ， .A..b..i..il..r..ixh. ixl 
レシス？一 . .» .!>. • •■). P .i) ll..i>l 

WXt . WIl . IxI 

Im p t / I ■レシ'天，-. .iyli..i>l 

U III t / f レジ： t ? - . I>r. ill-. Ill 1|> 

}；>| - Hi C - (• レジスター . 

ti II，ビ.トレンズ， 一.. Ik . dp.i\.Ap 

|il<l lb K / トレンスター . lx ilr M. n( 

■ • sh„n l>r Kl. •• I - ' » ■ 

|l + 127〜 -12 k ) 

:k !>rk 命令の « び ; 17 • ドレス、 UUliJJ 811,1011 .mil. 2011 . 2 8 h, 3 Uh. 3 «ili 
1111 |l(> ビ； rl ■ の抑 W. & しく アドレス 



■ 昤的に Wi を待避す s 









































加®命令 
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f-l** A R800 インストラクション表 


A .13 口ーテイト命令 


ニーモニック 命令利作 

S Z H'iN C 7654 

iiojHex b|c 

rola C 一. a l T|，. a «-_a«2 : .a‘[i—C _ 

.… 01 0000 

m 07 111 


.. 0 . 0 ： 1)00 

• . _ . . 

in 17ljl 
m 1TTT 

沾 r n - c 

I l 0 P 0 I UOU 

Oil CB 2 2 

oil C：U 2 5 
uo 06 

rol |.hl c—|.hlj<r, 

|.hl|*—[.hl]*2; .hl|ioj*—c 

I j o p o I urn 

rol |.ix+d] c*-|ix+d]ir) 

j.ix+d)—[.ix+d)»2 
[.ix+djio)*-c 

：Io p o i no 

loi DD 4 7 
on CB 

- 

no 06 

rol r .iy+«fl c*-1iy+3f(?> 

[.iy+d)-[.iy+d].2 

|.iy+d|(oi*-c 

I I 0 P 0 I 111 

101 PD 4 7 
on CB 

no 06 

r*-r/2;r(»(«-c 

1 l ° pot = 

on CB 2 2 

ror .£1) c»—fEl)(i>i 

11 。 p 。 1 = 

iio OE 2 5 

ror ..ix+dj' cq.ix+#,a, 

(.ix+dl—[.ix+d'/2 
j.ix+d)(»i*-c 

I I OP 0 J 1101 

101 DD 4 7 

no OE 

ror .iy+d| c*-Iiy+d](oi 

U.iy+d 卜 [.iy+d]/2 
||.iy+dli，i—c 

,lopo, *:« 

loi 4 7 

ou CB 









Uv ■■■ 

i: EITTirSj! iJUlJI] yfl Qgll 






K は問一 


































命令 i» 作 

flags 

SZH%NC 

为へコ 

7SM3210 

[hs|bc 

in .Mnj 

• a —W 


11011011 

DB 2 3j 

in r,(.c| 

w-lx| 

，，0P °* 

1 101 10 

ki) 2 .r 

in J,[.cJ 

R 

1,0P °* 

二： 

防？ 3j 

1 

in ![.hlj*-[.cj;.b«--b-l 

[Jil++],：.cl|.hl^.hl+l 

HU 


國 

in 

LMzzLlfl 

plj^|.c|;.b—.b-1 
.hi—.U-l 

KttfH 


mm 

ium 

.hl^.U+lnmtU ,b=0 


HB 

醐 


repcal;[.hJ]* j.clj.b'-.b -1 
.hl<-.bl-l;uirtU .b=0 

?，TT，> 

1101101 

0111010 

fED 2 4 
BA 3 

out nj,.a ||aj<-.a 


二。。二 

D3I2 S 

out |.q,r 

!•«]-* 



：^yy 



mi 


_ 

mm 

53135 

HH 


_ 

HR51gIBiE 225115 

HHKi 


ige 



IHi 


*l.b-l=0 のとき1、他は 0 


in J,[.c] は .c レジスターが示すポ-卜の内容によってフラグを変えるだけで、その内容は 
どこにも格納されなぃ 







iasEdQol 

innmEiajijul 

iffWTTTnHglllH| 
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R 800 かけ算命令用マクロ 


B .1 11800のかけ算命令 

R800 には、以下のかけ®命令があ •） ます。 








MSXView フアンクシヨンー覧 


C.1 ファンクション名順一覧 


拽能番 P 

名如 


ぺージ 

243 

•aboread。 

論理セクタを用いた嫌み出し 

496 

107 

•actioncntl() 

3ントロール実行中の表示 

574 

183 

*arc() 

円弧の描画 

431 

80 

.beckwin() 

ウィンドウを最後面に移肋 

394 

365 

.basename() 

パス名の解析（フ r イル名の®得） 

511 

367 

_bdoe() 

MSX--DOS2 システムコールの実行 (CS 
»胸 

513 

130 

.bkpixel() 

プロックへの点の畲き込み 

415 

129 

J>lcpoint() 

プロック上のカラーコードの播得 

415 

131 

J>lcread{) 

プロックからメモリへの嫌み込み 

416 

132 

_blcwrite() 

メモリからブロックへの®き込み 

416 

178 

-box() 

中を塗りつぶした四角形の描画 

429 

198 

.changecolor() 

エリア内の指定色の変更 

438 

357 

-chdir() 

カレン1■デイレクトリの変 E 

504 

229 

.chfileO 

カレントファイルの»定 

489 

60 

.chfont() 

々レン！•フォントの変更 

402 

371 

.chkverskm() 

MSXView のパージ3ン番号の検査 

515 

245 

■choice。 

ディスクフ*- マッ トメ ッ セージの後得 

496 

312 

•chpd() 

プリンタドライパの変 H 

624 

50 

xhpen() 

々レントペンの変更 

402 

140 

.chrwidthO 

文字蟆の獲得 

454 

269 

.chtext() 

カレントテキストの変更 

470 

84 

.chwin() 

々レントウインドウの変更 

396 

36 

.chwinker() 

カレントウイン々の変更 

549 




メニューのク〇—ズ 

VRAM パヴフ T のクロ- -X 

ウインドウのク〇— ズ 

7ァイル作成用フルパス名の後得 

报定色によるアイコンの描画 

エリアの3ビー 

7オントの ft： 成 

ペンの作成 

テキストの作成 

ウィンドウの作成 

ウィンカの作成 

カレント7 7•イルの播得 

カレント7オントの棰得 

汐レントペンの播 IS 

カレントテキストの播得 

カレントウインドウの®得 

カレントウィンカの搂得 

エリアの塗りつぶし （0R> 

フォントの削除 
ペンの削除 
テキストの削除 
ウインドウの削除 
ウインカの削除 
1文字表示 
アイ：3ンの描画 
1S 画エリアの狡定 

パス名の解析（ディレクトリバス名の痏得} 
KH 内のコント〇-ルすベての表示 
コント〇—ルの表示 
初期イ匕をともなうテキストの表示 
全角1文字表示 

ダイア〇グ上のアクシ 3 ンの捶得 
DOS コマン ドの実行 
パターンの表示 



195 

373 

251 

393 

253 

241 

225 

226 
366 

227 

238 

362 

387 

242 
376 
378 

381 

383 

385 

382 
381 

384 

386 
182 
185 
190 
180 
111 
103 


.errmes«age() 





-exitmo()ule() 

Ja]k>c() 
fclose() 
Jcreate() 
.feres te2() 

fdelete() 

ferror() 

JBret() 

_fflush() 

ffree() 

fgetattr() 

Jgetftimo() 

Jhdelete() 

Jhgetattr() 



.fhmove() 

JhsetattrO 

Jhsettime() 

_fiUoval() 

-fiUpniO 


-fiUpolygon() 



findcntlQ 

-findpart() 


カレントペンによるエリアの*りつ■&し 
メッセ—ジダイアログボックXの*示2 
オーパ—レイ乇ジュールの实行 
才ーパーレイモジュールの実行（任意の 7r 
イル） 

オーバーレイモジュール•チャイルドプ〇 

グラムの強制終了 

フ7•イルパッフ T の捜得 

ファイルのク〇 —ズ 

ファイルの新规作成 

7ァイルの新規作成（ァ(•リビュート指定 

ぁり） 

フ T イルの削除 
エラーコードの®得 
最初のエントリの検索 
デイ又クノ<ッフ T のフラッシュ 
ファイルッフ T の解放 
7ァイルのアトりビュートの梅得 
ファイルの日付と時劾の播« 

ファイルハンドルの削除 

■7 7•イルハンドルの T トリビュートの梅得 

7 T イルハンドルの日付と時刻の灌得 

ファイルハンドルの移動 

フ7•イルハンドルの名前の変® 

フ7•イルハン（••ルのアトリビュ_卜の»定 
ファイルハンドルの日付と時刻の a 定 
中を塗 1 )つぶし/•別の描® 

中を塗 1 )つぶした扇形の描画 
中を塗りつぶした多角形の描 a 
中を塗りつぶした角の丸い四角形の描画 
指定した座標を含むコントロ'-ルの検索 
パ-'!•ナン八一の®得 


437 

598 

499 
523 

500 


495 

487 

488 
512 


488 

493 



495 

516 

517 

518 

520 

521 

519 

519 

520 

521 
430 
432 
434 
430 
576 
572 





- ~~m 

JindwinO ゥ < ンドウハンドル， 


_flushcvc'nts() イベントキユーのクリア 

Jashjsystem() 澳字変換のキャンセル 

ftncnuO ファイルの送択 

fmovc() フ T イルの移軸 

-faew() 斯しいエントリの検索 

Jncxt() 次のフ r イルの梭* 

fuext2() 次のエン！•りの検索 

.fontadts() フォント悄報の®得 

Jopeu() フ5■イルのオーブン 

-formatO ディスクのフォーマット 

.fpathnext() 供»パスからの7ァイルの検索 

JpatlisetO ««パスからのファイルの検索の K 定 

_fpoint() 7 7•イルボインタの梅得 

-frameO 四角形の描両 

Jramearea() ェリアにしたがった四角形の描画 

_fread() カレン!•ファイルからの破み込み 

-free() メモリブロックの解放 

.freehlcO プロックの解放 

Jreelot() ロットの解放 

.(renameO ファイル名•ディレクトリ？;の変更 

.fro«twin() ウィンドウを ftifiSi に移動 

-feeek() 7ァイルボインタの»：定 

-fset() 7 7•イルの検索 

.feetattiO ファイルのアトリ fc： a ■ —）■の 

JsettimeO 7ァイルの日付と時刻の»定 

^aze() 7ァイルサイズの®得 

Jwrite() カレントフ7•イルへの嗇き込み 

^etalphkey() 嫌能コードがマッビングされているキーの 

播得 

.getarranumbei() 冷ーソルがあるエリアの灌得 
■getblcO ブロックから Wifi への表示 

.getcoordO カーソル座樣の播得 

.getcwdO カレントワーキングディレクトリの後得 

_getdate() 日付の捜得 

_getdetfont() デフォルトフォントの擭得 

.getdefpen() デフォルトぺ〆の播得 

.getdeviceQ ボインティングデイスの*得 




IK 液# 兮 挪 

~221 ^ptdSkiufo()' ディスク稱«の«得 

219 . B etdriv«() デフォルトドライブの推 W 


220 

135 

289 

146 

286 

19 


-getfileiiifoO 

getji^fcncO 



^etkcyfuncO 

-gctkeyinfo() 


イベント悄报の*得 
ファイル悄報の播得 
フォントハ•ターンの搂» 

櫬能コードの搜得 

JIS コードによるフォントパターンの嫌み 
込み 

檐能コードの後? TJ 
キーボード状想の»得 


292 4(etkeyu>ap() キーマップの®得 

360 getloginQ ディスクの掖統状況の ffift 


.getpaletteO パレットの播得 


27 •getpatnuml>cr() 勿レントカーソルの後# 

173 画， ib() ラパーパント*カラーの推 iS 

388 _getscreeninodc() スクリーンモードの播得 



310 
77 
88 
44 
157 
188 
118 
98 
21 
257 
10 
240 
147 
133 
57 
166 
285 
303 
150 
248 
47 

311 



-gtoI() 

.hide() 

-hiliteO 

.kndex() 

_initbjc() 

.initcntlO 



.initeveut() 

.initfalloc() 

jnitffile() 

.initfont() 

Jnitr<mthandle() 

-inKgrafQ 



Jnitmeniory() 

JniUne»u() 

Jnltoverlay() 

.iuitpenhdQ 



時刻の*得 

ウィンドウ情報の*掸 

グローパル座標から〇 _カル® tt への変換 

カーソルの iH 去 

メニュー項 B の強調 

上部のみ角の丸い四角形の 

ビブ1•ブロックマネージャの初期化 

u ントロールマネージャの初期化 

カーゾル表示の初期化 

ダイアログマネージャの初期化 

イペン!■マネージャの初期化 

7 7■イルアロケータの初期化 

フォントフ7•イルアクセスの初期化 

フォントパックの初期化 

フォントハンドルの初期化 

グラフ/<ックの初期化 

キーマップマネージャの初期化 

メモリマネージャの初期化 

メニューマネージャの初期化 

オーバーレイマネージャの初期化 

ペンハンドルの初期化 

ブリントマネージャの初期化 


392 

397 

S51 

589 

433 

412 

571 

S44 

5,5 

541 

494 

400 

425 

607 

399 

624 



梭能番号 
217 
264 
71 
33 
279 
1S8 
32 
252 
156 
160 

29 

26 

136 

176 

275 

89 
306 
287 
263 
359 
361 
261 
256 

193 

297 

174 

90 
81 
239 
121 
119 
109 
102 
258 
293 
153 



jnmp() 

J<eypopup() 

Jcillpatcui80[() 

.knjwidth() 

line() 

Jocatctext() 

麵〇 

jnalloc() 

jnapcntlkey() 



jnkdir() 

jnkfpath() 

jnodaldlg() 


-move() 



.cq>enaUcatl() 

-opendJg() 


1 ■味 

リソ ーx マネ ーy ャの初) 

テキストハンドルの初期化 
ウインドウマネージャの初期{匕 
ウインカの初期化 
文字列の押入 

メニュ 内のイペントのテスト 

ジ3プ#ーソルの設定 

MSXView アプリケーシ s ンの起勒 

シ3 — ( •カットキ—の Si 理 

ボップアップメニューでのシ 3 —トカット 

キーの* JJf 

カーソルの有効エリアの削除 
冷ーソルパターンの削除 
全角文字の«の獾得 
線の描迪1 

テキスト冷ーソルの移助 

口一々ル座樣からグロー/、•ル座橒への変換 

メモリプロックの播得 

後能コードのマッビング 

メ v セージダイアログボックスの表示 

デイレクトVの作成 

フルパス？;の播得 

モーダルダイアログのアクシ a ンの播得 
オーパーレイモジュール_チャイルドブロ 
グラムからの戻り®の擭得 
エリアの移» 

エリアの移助 
ペンの移動 

ポップアップウインドウ位匱の»定 
ウインドウの位 S の移勒 
MSX-DOS2 システムコールの実行 
新規ブ Q"/ クの*得 
新規ロットの剌り付け 
6己列内のコントロ—ルすベてのオーブン 
コントロールの才—ブン 
ダイアログボックスの表斥 
DA メニ a ■—のォ_ブン 
メニューのオーブン 


ぺージ 

— 

467 

389 

547 

474 

590 
547 
500 
589 

591 


546 

545 

452 

428 

473 

397 

61S 

608 

597 

505 

506 
596 
502 

435 

436 
428 
399 
394 
494 
413 
4)2 
575 
572 
595 
603 
587 


369 -pcmrec() 

314 -pd() 

54 .penadrs() 

201 4>bcel() 

189 .polygonf) 

231 ,popfile() 

63 .popfontO 

53 ,poppen() 

271 ,poptext() 

262 ,popupdlg() 

87 ,popwin() 

313 j)rintinfo() 

175 .pset() 

230 ,pu8lifile() 

62 .pushfontO 

52 ,pushpen() 

270 .pushtext() 

86 4>ushwin() 

37 .pushwinker() 

123 -putMc() 

13 .pHtevent() 

6 jd_sysdata() 

202 -readbit() 

148 -readgai'K) 

392 j-eadvb() 

278 jcdisptext() 

126 _resizeblc() 

82 ,reslzewin() 

128 jestoreblc() 


PCM の録音 612 

プリンタドライパの起勛 626 

ペン情報の ffi 得 404 

カラーコードの ft 得 439 

多角形の«两 433 

冷レントフアイルの ttUi 490 

フォントの愎谲 404 

カレントペンの银« 403 

テキストの«« 471 

ボップアップダイアログの表示とアクシ3 597 

ンの播» 

カレントウインドウの保袖 397 

カレン！•ウイン*の復 W 549 

ブリン！•悄報の擭得 624 

点の描！« 428 

保存をともなうカレント7 r イルの変史 490 

保存をともなうカレント7ォン！•の変 E 404 

保存をともなうカレントペンの変 K 403 

保存をともなったカレントテキストの変® 470 

保存をともなうカレントウインドウの変 E 396 

保存をともなうカレントウイン汐の史 E 549 

プロックへの保# 417 

イベント悄報のイベントキューへの追加 541 

システムデータの K み出し 602 

エリア内のカラーコードの 8E み出し 439 

外字ファイルの嫌み込み 455 

VRAM パッフ r からの较み出し 617 

テキストの再表示 468 

7ォン!•の更新 405 

ペンの史新 405 

プロックサイズの史圯 418 

ウインドウサイズの変更 395 

プ〇ックからの由像の取* J 出し 414 



角の丸い四 ft 形の描㈣ 

エりアにしたがった角の丸い》角形の描幽 

メモリブロックの®:得 

スタりーンモードの®定 

スクリーンサイズの推得 

エリ T 内のスクロール 

スクロール処埤 

メニュー項が进択されたときの*1理 
ポップアップメニューの％理 
カーソルの冇効箱域の变 C 
カスタムコントロールの;) (UU 付け 
バッファ中のテキストカーソルの移 M 
n 付の設定 

，ボインテイングデパイスの»定 
デフォルトドライプの a 定 
フォントスタイルの*® 

キーボード状他の按定 
キーマップの放定 
パレットの K 定 
カー y ルパターンの変 K 
ペンの St 定 

ラバーパンドモードの閉始.終了 
テキスト位 E の技定 
的雄:；£ 

ウインドウの変 IE 
力ーソルの表示 
タイトルの表示 
物®エラー％理ルーチンの议定 
イベント充生の調* 

プロックへの@像の保# 

文 r 列の<§の«得 
プロック内と画面の内像の交換 
次の垂夜同斯までの抒楼 
チャイルト•ブログラムの起» 

システム々ーソルの S 定 

エリアの*なりをテストするモードの開始 
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ペンハンドルの初期 lb 

ペンの作成 

ベンの«除 

カレントペンの変 e 

カレントペンの播得 

保存をともなうカレントペンの変更 

カレントペンの後!® 

ペン情報の理得 
ペンの e 新 

デフォルトペンの® i# 

フォントハンドルの初期化 

フォントの作成 

フォントの削除 

カレントフ<■ントの变 K 

カレントフォントの»得 

保存をともなうカレントフォントの変更 

フォン！•の«« 

フォント情報の®得 

フォントの更新 

デフォルトフォントの播擀 

ルー!•ボードのクリア 

ウインドウマネージャの初期化 

ウインドウの作成 

ウィンドウの才—プン 

ウィンドウのクローズ 

ウインドウの削铨 

ウインドウのクリア 

ウィンドゥ情報の播得 

ウィンドウの変 E 

ウィンドウを敁前面に移勛 

ウィン！••ウを最後面に移動 

ウィント•ウの位 S の移觔 

ウィンドウサイズの* E 

ウィント•ウハント•ルの擭得 

カレントウインドウの変更 

カレントウインドウの璀得 

保存をともなつ*レントウインドウの変更 

カレントウインドウの復帰 


399" 

400 

401 

402 

402 

403 

403 

404 

405 

406 

400 

401 

401 

402 

403 

404 

404 

405 

405 

406 
399 

389 

390 

391 

391 

392 
392 



393 

394 

394 

395 

395 

396 
396 

396 

397 





号名 1 R 


88 

89 

90 

91 

92 

93 
96 
101 
102 

103 

104 

105 

106 

107 

108 

109 

110 


-gtoiO 

Jtog() 

jnovepopup() 

juomwin() 

.endzoom() 

jnitcntl() 

•sctcntl() 

findpait() 

.dispcntK) 

.dispdlcntl() 

_actioncutl() 


111 Jindcntl() 

112 jlrivecntl() 

118 Jnitblc() 

119 _ncwIot() 

120 Jreelot() 

121 -newblc() 

122 土 eeblcQ 

123 .putblc() 

124 ^etblc() 

125 ^wapblc() 

126 jesizeblcO 

127 -storeblcO 

128 j-estoreblc() 

129 .blcpoint() 

130 .blcpixeK) 

131 _blcread() 

132 .blcwnteQ 



135 ^etfontpatQ 


SL 味 ジ 

グ〇—ハ•ル®掠から口ーカル座植への変換 397 

ローカル座®からグロ-'バル座榡への変換 397 

ボップァ -/ ブウィンドウ位 S の»定 399 

エリアのズーム 398 

ウインドウのズーム 398 

ズームの終了 398 

3ントロールマネージャの初期化 571 

* スタム：！ントロールの W り付け 571 

3ントロールのオープン 572 

パートナンパーの播得 572 

コントロールの表示 573 

配列内のコントロールすベての表示 573 

コントロールの実行 574 

コントロール支行中の表示 574 

コントロールのクローズ 575 

配 5!i 内のコントロールすベてのオーブン 575 

任意の座標がコントロールに含まれるかの 576 

検索 

楢走した座0!を ft むコントロールの検* 576 

コントロールドライパの¢1接呼び出し 577 

ビットブロックマネージャの初期化 412 

新現ロットの割り付け 412 

ロットの«放 413 

新现プロックの*得 413 

プロックの解放 413 

プ B ックへの保存 417 

プロックから曲面への表示 417 

プロック内と画 iff の画像の交換 418 

プロックサイズの変] E 418 

プロックへの画像の保存 414 

プロックからの«像の取り出し 414 

プロック上のカラーコードの播得 415 

プロックへの点の苺き込み 415 

ブロックからメモリへの読み込み 416 

メモリからプロックへの*き込み 416 

フォントックの初期化 451 

フォントスタイルの変更 451 

フォントパターンの®得 452 



機能签号 r,»i 

136 -knjwidth() 

137 _dfont() 

138 .dkanji() 

139 .dpatternO 

140 .dirwidth() 

141 .dstr() 

142 <strwi4th() 

146 _getjispat() 

147 jnitf&)e() 



150 jnitmeuu() 

155 _selectmenu() 

156 keymenu() 

157 JiiliU() 

158 jsn>enu() 

159 jielcdpopup() 


166 

167 

168 

169 

170 

171 

172 

173 

174 

175 

176 

177 


.imtgrafO 

testpos() 

.endtest() 



㈣ 〇 

Jrame() 


»味 ベージ 

"W 文字のの灌& 452 

1 文宇*示 453 

全角1文字表示 453 


パターンの表示 
文字皤の推得 
文字《の表示 
文卞列の幅の獲得 

JIS コー（••によるフォントパターンの說み 


453 

454 
454 

454 

455 


込み 

フォン!•ファイルアクセスの初期化 455 

外字7ァイルの嫌み込み 455 

メニューマネージャの初期化 587 

メニューのオーブン 587 

メニューのクローズ 588 

メニュー項 U が遵択されたと S の*！;理 588 

シ a_l •カットキーの热理 589 

メニュー項 B の強*! 589 

メニュー内のイベントのテスト 590 

ポップアップ〆ニューの Ja 理 590 

ポップアップメニューでのシ9ートカット 591 


キーの# i 理 

グラフパックの初期化 425 

ペンの a 定 425 

描画エリアの狡定 425 

E3 形の a なりをテストするモードの開始 426 

エリアの重なりをテス！•するモ -* ドの開始 426 

テス！•モ_ I••の終了 427 

ラパーパンドモードの開始•終 j* 427 

ラパーパンI••カラ—の播得 427 

ペンの移抑 428 

点桃画 428 

線の描幽 428 

四角形の描® 429 








画り 角出込 変ルみ 
画一! 描塗し 四みき の イみ込 
I 画 画描 描 ののぶ R ) い K * 化 名 T 込み 
描描め の 形アつ《§丸のの期定得 リ フき较 
の の ； g 形 角リり OFKXC の ドド初»»卜定卜«番の 
形 ン角 角ル 四 X *<*< 角 II ののの ク»ン悝のら 
扇3四 多： たるのしのした得 n 3 ャププ»» 索 , >- ズ成 レのレのへか 
たイい た D っょアぶ色ぶっ播 II ジイイ播推 検ブー作 ィルカルルル 
し！：ア丸 しク| がにリつ定つがのララ I ララのの索の I 口規除デイぅイイイ 
ぶ描るの画ぶスビ助たンエ 9 指りたドカカネドド報 ffi 検ルオク新削‘ T な TTr 
画つのょ角描つのコ移しべの塗の*!し I ののマトト悄 W のイのののの名フもフフフ 
1描描リンにみのり内ののに卜での内のに n 内へスルルルクル T ルルルルルトとトトト 
1のの塗 n 色の形 ■« アアアアン色ア T アア I アア I オオイスイフイイイイインをンンン 
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TI 扇中ア指上多中 xxx ェカ指 X XXX 力 H H リデデ 7 r 7 次フフフフフカ保力*力 
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239 

240 

241 

242 

243 

245 

246 

247 

248 

251 

252 


254 

256 

257 

258 

259 

260 
261 
262 

263 

264 

265 

266 

267 

268 

269 

270 

271 

272 

273 


initfalkx:() 

falloc() 

Sree() 

_absread() 

-choicc() 

.fonnat() 

.currcntfileQ 

.initoverlayO 

.execute() 

-jump() 

-exitmcxliile() 

■system() 

.roodulevalue() 

-initdlg() 

-opendlg() 

-closedlg() 

.dlgselect() 

jnodaldlg() 

•popupdlg() 



Jnittcxthd() 

_createtext() 

-disptcxt() 

-ddetetcxt() 

-currenttextO 

.chtext() 

.poptext() 


MSX-DOS2 システムコールの突行 

ファイルア〇ケータの初期化 

フ r イルメ<ッフアの按得 

77•イルバッフ T の解放 

綸理セクタを用いた a み出し 

ディスクフ*ーマットメクセージの播» 

デイスタのフォーマット 

カレント7 7■イルの®得 

才_メ<ー レイマネージャの初期化 

才ーパーレイモジユ•-ルの実行 

MSXView アプリケーシ9ンの SW 

才—パーレイモジ A — ル • チヤイ/レ|»*プ D 

グラムの強制終了 

チャイルドブログラムの起肋 

才 一 /«_レイモジ》_ル • チヤイルドブロ 

グラムからの戻の擭得 

ダイア13グマネージャの初期化 

ダイア tJ グボックスの表示 

ダイア D グボックスのク〇—ズ 

ダイア〇グ上のアクシ3ンの灌得 

モーダルダイアログの T クシ a ンの®得 

ポップアップダイア〇ダの®示と T クシ a 

ンの*得 

メッセージダイア D グボックスの表示 
テキストハンドルの初期化 
テキストの作成 

初期化をともなうテキストの*示 

テキストの削除 

カレントテキストの®得 

カレントテキストの* g 

保存をと6なったカレントテキストの変 M 

テキストの復« 

テキスト構造体の®得 
テキストの編集 


494 

495 

495 

496 

496 

497 

497 

498 

499 

500 

500 

501 
512 

595 

595 

595 

596 

596 

597 

597 

467 

467 

468 

469 

469 

470 

470 

471 

471 

472 



304 

305 

306 

310 

311 

312 

313 

314 

357 

358 



_sbrk() 

-free() 

.setdate() 

getdate() 



.gettimc() 

JnitpnntQ 

.chpd() 

-pd() 

.chdir() 

•getcwdO 

-inkdir() 

getlogin() 


メモリマネージャの初期 < 匕 
メモリブロックの®得 
メモリブロックの解放 
メそリブロックの®得 
日付の说定 
□ 付の播得 
時劾の a 定 
時刻の播得 

ブリントマネージャの初期化 
ブリンタドライパの変® 

プりンI•情報の播得 
プリンタドライパの起勒 
レン！•デイレクトリの変竃 
カレントワーキングデイレクトリの播15 
デイレクトリの作成 
ディスクの锒技状況の«褂 


614 

614 

615 
615 
604 

604 

605 
605 
624 
624 

624 

625 
504 

504 

505 
505 





檐能番玲名物 

361 aniifpstbO 

362 -ffirstO 

363 .fnc*t2{) 

364 .dirnameQ 

366 fCTeate2() 

.167 bd«s() 


368 

369 

370 

371 

372 

373 

374 

375 

376 

377 

378 

379 

380 

381 

382 

383 

384 

385 

386 

387 

388 

389 

390 

391 


•pcm|Jay<) 

•pcmrecO 



fKetattrO 

.f»ctattr() 

.fgetftime() 

-fecttime() 

fl>delete{) 

fhgetattr() 

.fhsetattrO 

.fflush() 

.dosevb() 

writevb() 


聪 ベージ 

フルパス名の! gfe 506 

ffi 初のエン！•りの検索 508 

次のエントリの枝索 509 
パス名の解析（ディレクトリパス名の®得） 510 

パス名の解析（フ T イル名の播得） 511 

ファイルの新規•:成（アトりビ》ー ト指定 512 

あ，” 

MSX DOS2 システム： J _ルの実む r (C S 513 

抵.対 <£•) 

PCM の再生 012 

PCM の »t 012 

新しいエントリの検索 514 

MSXView のバ■ジョン番号の検7¢ 515 

タイトルの表示 605 

メッセージダイアログボックスの长示2 598 

Xクリーンサイズの8?# 407 

ファイルの移助 515 

フ T イルのアトリビュートの®得 516 

ファイルのアトリビュートの»定 516 

ファイルの日付と時刻の®得 517 

ファイルの日付と時刻の;8：定 518 

フ T イルハンドルの M 除 518 

ファイルハンドルの名期の! CH 519 

フ T イルハンドルの移動 519 

ファイルハンドルのアトリビ * — 卜の®得 520 

フ T イルハンドルのアトリビ ■> ■—卜の*！:定 520 

ファイルハンドルの日付と時刻の播得 521 

ファイルハンドルの B 付と時刻の»定 521 

デイXクバッ 7T のフラッシュ 522 

Xクリーンモードの搜搀 407 

VRAM パッフ r の才ーブン 615 

VRAM パッ77■のクローズ 616 

VRAM パフ T への軎I•込み 616 



~4l4 JpathMitO 複 e パスからのフ r イルの投索の » 定 525 

415 JpathnextO 複 ft パスからのファイルの検索 526 

416 .signal() 物理エラー) Q 瑰ルーチンの K 定 526 


[_注意| 檐能#号の空いている部分はシステム _J "•約の77■ンクシ3ンです。システム 
予約のフアンクシ3ンをコールした場については保証されません。 



サンプルブログラム 


サンプルプ〇グラムに入っているプログラム（以下、サンプルブ〇グラム）は， I-MSX 
DatapackturboR 版 j の登録ユーザーの方であれば、ユーザ_ブ〇グラムに組み込んで使 
用することができます，そのユーザーブ〇グラムを販売•頜布する場合•も、弊社との契約は 
必要ありません • また、その IS、 弊社の Copyright 表示なども必要ありません • 

ただし、サンブルブ〇グラムの著作権は株式会社アスキーが保有します • したがって、一 
部または全部に関わらず、サンプルプログラムの内容をそのまま、舉体で第三者に阪売•頒布 
することは禁止します，向様に、パソコン通信において、サンプルプログラムのソースコー 
ドまたはオブジェクトブ〇グラムを*体でホストコンピュータにアップ〇— ！••することは禁 
it します。 

サンブルプログラムの内容およびマニュアルの正»情»などは、サンプルディスタのファ 
イルに K 嫌します，サンプルプログラムを使う齣に，以下の7アイルをご»下さい， 


表 4.12 サンブルブ〇グラムの情報を嫌した7アイル 





索引 


■记号 

/P . ..52 

■ ft 字 

1阃而ごとの出力伴止. ..52 

1バイト®の別名定 «. ...355 

16ビット移動命令 .... ... ,662 

8ビット移動命令 . ...661 

8251 . 631 

8253 . 631 

8254 . 631 


■ A 

ABORT ... 
ABORTUP 
APLLOT .. 
APPEND 

AREA . 

ASCIIZ 文字列 . 

ASCII コビ ー.. 
ASCII 7 r ィ，レ 

ASSIGN . 

ATDIR . 

ATTRIB . 


530 
530 
409 
..47 
.3 S 6 
.. 226, 232 
S9 
.SO 

70 

71 
.73 


■ B 

BARTMP 
BASIC .... 
BIOS コ-ル 
BLCTNFO . 
BLOAD 
BSAVK . 
BUFFKRS . 


.362 
.75 
.235 
357 
..22 
..22 
.76 


BUTTON-CNTL . ..558 

BWIN . . .383 
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お問い合わせについて 


邦社で Uft 重に獮包した上、細心の注意を払って製品を発送しております。6—、輸送上 
のトラブルが起こった塌合にはご一>ただけれぱ斯しいものと交換いたします。 

マニュアル 作成にあたり、なるべく詳細な St 明をするように心がけたつもりですか、理解 
て S な•いところは、笑除にコンビユータと向 S 会って納得のゆくまで確めて下さい • また， 
他のページを#照するのも1つの方法です_>それでも«問点が解決できないときは、纣羚に 
て、下 iid の®領でお問い会わせ下さい • このパッケージの性格上、茁话でのお答は不可能と 
疗しますので、恐れ人りますが、ご了*ドさいますようお W い申し!•:げます， 

また、木以外に対してのこ«54、ご希望がありましたら、弊社までお寄せ FS い • 

1. 送付先 

干107 24 «京都港 K 南 U 山 6-11-1 スリーエフ南#山ビル 

株式会社アスキーユーザーサポート係 

2必要ポ項 

( a ) お客檐の氏名，住所（《便*4)、窀话番分（布外局*も含む） 

( b ) 製品名、 saa ンリアル*皆、ユーザー I •番号 
(C) 機器桷成 

本体*:5名、メモリバイト R 

CRT 装'2名、フロッピーディスク装两} 

ブリンタ装武名 
その他 I / O 、 I / F 装黄名 
(4) お問い合わせ内 W 

お問い合わせの内容は、できるだけ K 品のマニュアルに纪述されている用搭を用 
いて、 ft 体的かっ明*に£述して下さい，なお、»苦と思われる現象にっ“ては、 
その*見象を再現可能な WK が必要です。汽社で再現できないものは、拥变ができ 
ません。その現象が発生するまでの播作寻•順.データを必ず添付して下さい，デー 
タディスタがある場合は、そのコビ•■も向封していただくと两变がスピーディに 
なります。 

また、お•各枝|爸有と思われるアブリケーシ3ンの;9:計、作*;、運用、保守につ“ 
ては，当衧のサポート* E 两外ですので、お問い■わせいただいても间答できませ 
ん•例えば、 r このブログラムリストはなぜ#かないのか」といった CH 問にはお 
答えできません。こ承知ドさいますようお顯いいたします。 
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